home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / netutils / brir110e.arj / DOC.ZIP / REF.TXT < prev   
Text File  |  1994-06-29  |  117KB  |  2,547 lines

  1. Part Six: Reference   
  2.    
  3.  List of Topics: 
  4. 29.0 BrightWorks Error Messages 
  5. 29.1 Inventory Error Messages 
  6. 29.2 Metering Error Messages 
  7. 29.3 Script Editing Error Messages 
  8. 29.4 Software Distribution Error Messages 
  9. 29.5 Software Distribution Update Program Error Messages 
  10. 30.0 Troubleshooting 
  11. 30.1 Installation and Set-up 
  12. 30.2 Cannot Meter 
  13. 30.3 LockSet Does Not Release
  14. 30.4 SMRUP Patches
  15. 30.5 SiteMeter Reports
  16. 30.6 BTRIEVE
  17. 30.7 Changing the SiteMeter Messages
  18. 31.0 Equipment Database 
  19. 31.1 Equipment Inventory Records 
  20. 32.0 Using Brequest 
  21. 32.1 Using the Btrieve NLM 
  22. 32.1.1 Using the NLM with EQUIP 
  23. 32.2 Using Brequest in a Login Script 
  24. 32.3 Using the Btrieve VAP 
  25. 33.0 Btrieve Status Codes 
  26. 33.1 Btrieve Status Codes 
  27. 33.2 Client-Based Btrieve for OS/2 and Windows Status Codes 
  28. 33.3 Btrieve Requester Status Codes 
  29. 34.0 NMS Smart-Launch Support 
  30. 34.1 Enabling BrightWorks Smart-Launch within NMS 
  31. 34.1.1 Activating the Smart-Launch Feature 
  32.  
  33.   
  34. 29.0 BrightWorks Error Messages   
  35.    
  36. This appendix lists all error messages associated with BrightWorks.  The    
  37. error messages are listed alphabetically in each of the following categories:   
  38.    
  39. o  Inventory Error Messages   
  40. o  Metering Error Messages   
  41. o  Script Editing Error Messages   
  42. o  Software Distribution Error Messages   
  43. o  Software Distribution Update Program Error Messages   
  44.    
  45. 29.1 Inventory Error Messages   
  46.    
  47. The following error messages may be displayed while using BrightWorks'    
  48. inventory features.   
  49.    
  50. Add Inventory - This Field Cannot be Left Empty   
  51.     The Site field must contain information.   
  52.    
  53. Audit Not Completed On Site    
  54.     The audit was not successfully completed.   
  55.    
  56. Btrieve Error   
  57.     All Btrieve errors are reported by a number. Refer to Chapter 33.0   
  58.     to discover the reason for the error.   
  59.    
  60. Cannot Copy File - Source File   
  61.     The source file names for saving the baseline may not be set    
  62.     properly; there may not be enough disk space; you may not have    
  63.     sufficient rights to the destination directory; or the files might    
  64.     be flagged as Read Only.   
  65.    
  66. Cannot Create File - Target File   
  67.     The target file(s) for saving the baseline could not be created.    
  68.     Check rights and disk space/directory entries.   
  69.    
  70. Cannot Delete a Pre-Defined Report   
  71.     The reports that are provided with BrightWorks cannot be deleted.   
  72.    
  73. Cannot Initialize Btrieve   
  74.     Btrieve failed to initialize; check available memory.    
  75.    
  76. Cannot Initialize Libraries    
  77.     DATALIB and/or WNCFS DLL's are missing. Check available memory.   
  78.    
  79. Cannot Re-Define this Report   
  80.     The reports that are pre-defined and provided with BrightWorks    
  81.     cannot be re-defined.  Try saving the report under a different name.   
  82.    
  83. Could Not Access Shell Network Information   
  84.     Your network is not responding.  You must reboot the machine and    
  85.     retry the operation.   
  86.    
  87. Could Not Create ID File   
  88.     The file that generates IDs for stand-alone equipment could not be    
  89.     created. Check that the diskette is not write protected.   
  90.    
  91. Could Not Login to Server   
  92.     The name/password you entered is invalid.   
  93.    
  94. Delete Unidentified Software - This Item is in the Transfer List - Delete    
  95. it First.    
  96.     A software title that is included in the transfer list was selected    
  97.     to be deleted. It must first be removed from the transfer list.   
  98.    
  99. Entry Is Reserved for Fusion Use, Cannot Edit Entry   
  100.     Some Categories, Classes and Types are reserved for BrightWorks    
  101.     use and cannot be edited or deleted. The following fields cannot    
  102.     be left blank:   
  103.    
  104.         -  Category    
  105.         -  Class   
  106.         -  Manufacturer   
  107.         -  Product Name   
  108.    
  109.     For PC and MAC Software Lists, the following fields cannot be left    
  110.     blank:   
  111.    
  112.         -  Product Name   
  113.         -  File Name/File Creator   
  114.         -  File Size       
  115.         -  Version Number      
  116.    
  117. Error # Deleting Report   
  118.     The system encountered the specified error attempting to delete    
  119.     a report.   
  120.    
  121. Error #: Server "server name"   
  122.     A network error occurred on the specified server. Consult NetWare    
  123.     documentation for a description of the error number.   
  124.    
  125. Error Allocating Global Memory   
  126.     BrightWorks could not allocate extra memory to store system files.   
  127.    
  128. Error Reading Audit Parameters   
  129.     The file WAUDCFG.DAT, which contains the Audit parameters, could    
  130.     not be read.   
  131.    
  132. Error Removing Alert Timer   
  133.     The system was unable to remove the timer for alerting.   
  134.    
  135. Error Removing Audit Timer   
  136.     The system was unable to remove the timer for an automatic audit.   
  137.    
  138. Field Type Do Not Match   
  139.     The BrightWorks field format (character or numeric) and the field    
  140.     to be imported format differ.   
  141.    
  142. File 'WEQTRNA.DXT' Could Not be Found    
  143.     The path specified to load stand-alone equipment from does not    
  144.     contain this file, which is needed for the stand-alone hardware.   
  145.    
  146. Invalid Hour Entry   
  147.     Entry must be in the range 12 AM - 12 PM.   
  148.    
  149. Invalid Minutes Entry   
  150.     Entry must be in the range 0 - 59.   
  151.    
  152. Local Site Already Has This Name   
  153.     The name you entered is already assigned to the local site.     
  154.     Select a different Site name.   
  155.    
  156. Local Site Cannot be Deleted   
  157.     The Site name you wish to delete is the name of the local site and    
  158.     cannot be deleted.   
  159.    
  160. Local Transaction Files Could Not be Found    
  161.     The directory from which BrightWorks is running does not have the    
  162.     local transaction files to which stand-alone information should be    
  163.     loaded. To solve this, add a search drive set up to BrightWorks.  
  164.    
  165. Login Name Cannot Be Left Empty   
  166.     The Login Name field cannot be empty when specifying access to a    
  167.     server.   
  168.    
  169. Macintosh Update Aborted   
  170.     The Macintosh update was aborted at user's request.   
  171.    
  172. Memory Allocation Error   
  173.     The system was unable to allocate memory for the specified    
  174.     operation.  Close one or more applications and try the operation    
  175.     again.   
  176.    
  177. NetWare Error   
  178.     Could not attach to server due to one of the following:    
  179.         -  a hardware error   
  180.         -  the 8 server slots are in use   
  181.         -  the maximum number of users for the server has been    
  182.         reached   
  183.    
  184. No Data For This Report   
  185.     There was no data satisfying the filtering conditions set in the    
  186.     report.   
  187.    
  188. No Fields Selected   
  189.     At least one field must be selected to print for the Custom Report    
  190.     or the Detailed Equipment Report.   
  191.    
  192. No Fileservers Specified   
  193.     No servers were included in the Audit.   
  194.    
  195. No Sites Specified   
  196.     No sites were specified in the Scope of Audit.   
  197.    
  198. Not Enough Disk Space Available   
  199.     The collector diskette does not have the space needed for    
  200.     stand-alone files.   
  201.    
  202. Option Available Only from Menu Bar (Delete Component)   
  203.     When creating new equipment components, bringing up the list of    
  204.     components, the user cannot delete an existing component.   
  205.    
  206. Path Name Cannot be Left Empty - Edit Site   
  207.     The Path Name must contain information when editing sites.   
  208.    
  209. Path Name is Already in Use   
  210.     Sites must be assigned unique path names.   
  211.    
  212. Product has Not been Installed   
  213.     BrightWorks needs to be properly installed following the instructions    
  214.     in Chapter 2 of this manual.  If the program has been properly    
  215.     installed, run CIN.EXE to re-enable BrightWorks.   
  216.    
  217. Required Fields Are Missing   
  218.     One or more of the fields that uniquely identify a workstation are    
  219.     missing: site - nodeid_1 - nodeid_2 - name.   
  220.    
  221. Selected Fields Will Not Fit on Page   
  222.     Using the current page set-up, the fields that have been selected    
  223.     for printing will not fit across the page.  Either select a smaller    
  224.     font, set a smaller maximum field width, select the "One Field Per    
  225.     Line" option, or select fewer fields to print.   
  226.    
  227. Server Update Aborted   
  228.     Server update aborted at user's request.   
  229.    
  230. Server Update Not Completed   
  231.     File Server information was not updated in the transaction file due    
  232.     to one of the following reasons:   
  233.         - The file WSERVER.DAT (containing the list of servers)    
  234.         could not be read   
  235.         - No servers were included in the Scope of Audit   
  236.         - No unique ID could be determined for that server   
  237.    
  238. Site Name Cannot be Left empty - edit site   
  239.     When editing a Site, the Site field must contain information.   
  240.    
  241. Source File Not Specified   
  242.     When backing up the baseline, the source baseline file must be    
  243.     specified.   
  244.    
  245. Supervisor Rights Required   
  246.     Supervisor rights or equivalent are needed to run an audit on a    
  247.     server.   
  248.    
  249. System Files To Audit - This is Not a Valid File Name   
  250.     A valid file name is up to 14 characters long; the period is required.   
  251.    
  252. The Transaction File Is Empty   
  253.     The transaction file is empty due to one of the following reasons:   
  254.    
  255.         - EQUIP has not been run   
  256.         - MAC files were not loaded into the transaction files   
  257.         - Stand-alone equipment has not been loaded   
  258.         - The file server information update failed   
  259.    
  260. There is no Audit Selected   
  261.     When running the Audit Results Report, a specific audit must be    
  262.     selected.   
  263.    
  264. Transfer Unid Software as Group - Base Name / Version No. Already In Use   
  265.     The combination of base name / version no is in use by another    
  266.     software title.   
  267.    
  268. Unable to Configure Printer   
  269.     The system was not able to initialize the printer.  Make sure that    
  270.     a printer is set up for Windows and the correct driver is present    
  271.     in the Windows system directory.  If necessary, delete the file    
  272.     WLAI.INI from the Windows directory and try to print again.   
  273.    
  274. Unable to Create Timer Window   
  275.     The system was unable to create the timer window for an automatic    
  276.     audit or alerting.  This is probably due to low memory or system    
  277.     resources.  Close one or more applications and try the operation    
  278.     again.   
  279.    
  280. Unable to Create Window   
  281.     The system was unable to create a window.  This is probably due to    
  282.     insufficient memory or system resources.  Close one or more    
  283.     applications and try the operation again.   
  284.    
  285. Unable To Determine Unique ID   
  286.     The file that stores the unique file server ID, which is in the    
  287.     SYS:SYSTEM dir as a hidden file called LAIID.CFG, could not be    
  288.     created or opened.  If the hidden file is zero bytes, delete it    
  289.     and try again.   
  290.    
  291.     This message might also appear if the number of files in use    
  292.     exceeds the maximum number specified in the CONFIG.SYS file    
  293.     (usually when the user is running other Windows or DOS applications).   
  294.    
  295. Unable to Initialize NetWare Structures   
  296.     Your network is not responding.  You must reboot the machine and    
  297.     retry the operation.   
  298.    
  299. Unable to Initialize Timer   
  300.     The system was unable to initialize the internal timer used to    
  301.     track automatic audits and alerts.  This is probably caused by    
  302.     other applications using all system timers.  Close an application    
  303.     that uses a timer and try the operation again.   
  304.    
  305. Unable to Open Export File   
  306.     The user must have write/create rights, and there must be enough    
  307.     disk space to create the export file.  If you are trying to export    
  308.     to a root directory, try exporting to a sub-directory instead.   
  309.    
  310. Unable to Open File   
  311.     The system was not able to open the specified file.  Make sure that    
  312.     a valid directory was specified and that the user has sufficient    
  313.     rights to this directory.   
  314.    
  315. Unable to Open Import File   
  316.     The file selected to be imported could not be opened. The file could    
  317.     be corrupted.   
  318.    
  319. Unable to Open Report Files   
  320.     The system was not able to open the files which contain the data    
  321.     being reported.   
  322.    
  323. Unable to Retrieve Report Information   
  324.     The system was not able to open or read one or more of the files    
  325.     required to run the specified report.  Before creating reports, you    
  326.     must run an audit and have data in your baseline.   
  327.    
  328. Unable to Write to Temporary File   
  329.     There is not enough disk space for the temporary file.  Free up    
  330.     some space, and then run the report again.   
  331.    
  332.    
  333. 29.2 Metering Error Messages   
  334.    
  335. The following error messages may be displayed while using BrightWorks'    
  336. metering features.   
  337.    
  338.    
  339. A print destination must be chosen.   
  340.     Please select a printer in the printer setup dialog box to run    
  341.     a report.   
  342.    
  343. A report type must be selected.   
  344.     Please specify a report type in the reports dialog box to run a    
  345.     report.   
  346.    
  347. A server must be selected.   
  348.     Please specify a server in the reports dialog box to run a report.   
  349.    
  350. A source file must be indicated.   
  351.     Please specify an input source in the reports dialog box to run a    
  352.     report.   
  353.    
  354. A valid date range must be provided.   
  355.     Please specify a date range for filter criteria in the reports    
  356.     dialog box to run a report.   
  357.    
  358. Are you sure you want to export the data?   
  359.     Choose the Yes button to continue with the export of the data file.    
  360.    
  361. At least one filter criteria choice must be given!   
  362.     Please specify at least one of the filter criteria, either date,    
  363.     user, or application.   
  364.    
  365. File size exceeds 65,535 lines.  Unable to export.   
  366.     The data file is too big to be exported any of the standard formats.     
  367.     Please try Btrieve as the export type.   
  368.    
  369. Invalid user name supplied.   
  370.     Please specify a valid user name in the attach dialog box.   
  371.    
  372. No additional servers can be found.   
  373.     BrightWorks' metering capability could not detect additional servers.   
  374.    
  375. No default printer!  Select a printer from PRINT SETUP menu.   
  376.     Please select a printer in the printer setup dialog box to run    
  377.     a report.   
  378.    
  379. No input file specified.  Cannot continue.   
  380.     Please specify the name of the input file.   
  381.    
  382. No output file specified.  Cannot continue.   
  383.     Please specify the name of the output file on the export dialog    
  384.     box for data output.   
  385.    
  386. No output type specified.  Cannot continue.   
  387.     Please select one of the output formats specified in the    
  388.     drop down list.   
  389.    
  390. No server specified.  Cannot continue.   
  391.     Please select a server to generate reports.   
  392.    
  393. No source type specified.  Cannot continue.   
  394.     Please specify one of the four radio buttons on the export dialog    
  395.     box for input source.   
  396.    
  397. Please select or enter a server name before pressing the OK pushbutton.   
  398.     Please specify a server in the attach or detach dialog box.   
  399.    
  400. Report setup choices incomplete.   
  401.     All selections necessary to run reports have not been made in the    
  402.     reports dialog box.   
  403.    
  404. The 'sitedata' file has been corrupted. Please contact McAfee Technical    
  405. Support for assistance.   
  406.     Cannot read the SITEDATA file.  Please contact McAfee Technical    
  407.     Support for assistance at 908-530-9650.   
  408.    
  409. Unable to establish connection with DataLIB DLL.  Cannot continue.   
  410.     Please check to see that the file DLWBC31.DLL is in the same    
  411.     directory as SREPORT.EXE.   
  412.    
  413. Unable to initialize Btrieve DLL file.   
  414.     Please check and make sure that the files WBTRCALL.DLL and    
  415.     WBHANDLE.DLL are in the same directory as SREPORT.EXE.   
  416.    
  417. Unable to initialize DataLIB DLL; export functions will be unreliable.   
  418.     Please check to see that the file DLWBC31.DLL is in same directory    
  419.     as SREPORT.EXE.   
  420.    
  421. Unable to open input file.  Cannot continue.   
  422.     Please check to see that the input files SITEDATA or VIRUSDTA are    
  423.     in the directory you have selected.   
  424.    
  425. Unable to open output file.  Cannot continue.   
  426.     Please check to see that the file DLWBC31.DLL is in the same    
  427.     directory as SREPORT.EXE.   
  428.    
  429. When 'File' is the print destination, a file type must be selected.   
  430.     Please specify an output file name to print a report to a file.   
  431.    
  432. Would you like to export new baseline source files for your report?   
  433.     Choose the Yes button to continue with the export of the data files.     
  434.     You may choose the No button if you have recently exported the data    
  435.     files.  This will save some time in the report generation process.    
  436.    
  437. Unable to create Btrieve output file. File may be in use.   
  438.     The Btrieve data output file with extension .DAT may already be in    
  439.     use by another user.  Ensure that no one else is using the file and    
  440.     try again. If the problem still persists, please use the Btrieve    
  441.     utility provided by NetWare.  Type BUTIL -RESET filename.DAT.   
  442.    
  443. Unable to create peaks.dat file.   
  444.     The Btrieve data output file PEAKS.DAT may already be in use by    
  445.     another user.  Ensure that no one else is using the file and try    
  446.     again.  If the problem still persists, please use the Btrieve    
  447.     utility provided by NetWare.  Type BUTIL -RESET PEAKS.DAT.   
  448.    
  449. Unable to initialize Btrieve requester.   
  450.     Btrieve requester Brequester may not be running.  Please exit Windows    
  451.     and run BREQUEST.EXE.   
  452.    
  453. Unable to insert Btrieve record.   
  454.     Btrieve was unable to insert one of the records in the export process.     
  455.     The original file may be corrupted, please call McAfee Technical    
  456.     Support.   
  457.    
  458. Unable to open peaks.dat file.   
  459.     The Btrieve data output file PEAKS.DAT may already be in use by    
  460.     another user.  Ensure that no one else is using the file and try again.     
  461.     If the problem still persists, please use the Btrieve utility    
  462.     provided by NetWare.  Type BUTIL -RESET PEAKS.DAT.   
  463.    
  464. Unable to open sitedata.dat file.   
  465.     The Btrieve data output file SITEDATA.DAT may already be in use    
  466.     by another user.  Ensure that no one else is using the file and    
  467.     try again.  If the problem still persists, please use the Btrieve    
  468.     utility provided by NetWare.  Type BUTIL -RESET SITEDATA.DAT.   
  469.    
  470.    
  471. 29.3 Script Editing Error Messages   
  472.    
  473. The following error messages may be displayed while using BrightWorks'    
  474. script editing features.   
  475.    
  476. Another script is already using this file.   
  477.     You must enter a unique file name for each script.   
  478.    
  479. Do you want to save the changes?   
  480.     You have tried to close the script editor window without saving    
  481.     your changes.  Choose the Yes button to save your editing changes    
  482.     and close the script editor, or choose the No button to cancel    
  483.     your changes.   
  484.    
  485. Duplicate names are not allowed.   
  486.     A script with this name already exists.  Enter a unique name.   
  487.    
  488. File does not exist.   
  489.     The script source file cannot be found.  Verify the drive and    
  490.     directory on which you are searching.   
  491.    
  492. File exceeds capacity of this editor.   
  493.     A script source file cannot exceed 64k in size.   
  494.    
  495. Source and target file names are the same.   
  496.     You must enter a target name that is different than the script    
  497.     source file name.   
  498.    
  499. Text Not Found.   
  500.     The string being searched for via the Find String dialog box    
  501.     cannot be found.    
  502.    
  503. There is no entry selected.   
  504.     You must first select a script before choosing the delete or    
  505.     rename options.   
  506.    
  507. This script cannot be deleted because it is a part of a scheduled package.   
  508.     You cannot delete a script that is part of an actively scheduled    
  509.     package.   
  510.    
  511. Unable to create new file.   
  512.     The new script source file cannot be created.  Verify that you    
  513.     have sufficient rights to create the new file.   
  514.    
  515. You cannot edit more than eight documents at a time.   
  516.     You can have a maximum of eight script editor windows open.   
  517.    
  518.    
  519. 29.4 Software Distribution Error Messages   
  520.    
  521.    
  522. The following error messages may be displayed while using BrightWorks'    
  523. distribution features.   
  524.    
  525. # node(s) have been deleted from the Inventory since the last time this    
  526. scope was edited.  These nodes will be deleted from this scope and the    
  527. corresponding packages upon saving.   
  528.     Some nodes have been deleted from your baseline since the last time    
  529.     you modified this scope.  These nodes will be deleted from your    
  530.     scope and all packages this scope is attached to when you save the    
  531.     scope.   
  532.    
  533. A site must be defined before this feature may be utilized.   
  534.     You must define a Site before using any of the distribution    
  535.     features (Packages, Scopes, etc..).   
  536.    
  537. An error occurred compressing fileset.   
  538.     An internal compression error occurred.  The file(s) in the fileset    
  539.     may be corrupt.   
  540.    
  541. An error occurred copying a file.   
  542.     An error occurred while copying a fileset.  Check your rights and    
  543.     the available disk space.   
  544.    
  545. An invalid path to filesets was detected.  It has been reset to the    
  546. current directory.   
  547.     This is an informational message.  It generally occurs if you    
  548.     change the drive mapping from when BrightWorks was originally    
  549.     installed.  Use the Administration/Distribution/Preferences menu    
  550.     commands to set the fileset path to the desired location.   
  551.    
  552. Could not create Fileset "<name>".   
  553.     The fileset could not be created.  Check your rights and available    
  554.     disk space.   
  555.    
  556. Could not create the target file.   
  557.     Unable to create the new fileset during a copy.  Check your rights    
  558.     and the available disk space.   
  559.    
  560. Could not locate the Fileset for this package.   
  561.     Either the fileset has been deleted, or the path to the filesets    
  562.     has been changed.  Verify the path to filesets from    
  563.     Administration/Distribution/Preferences menu commands.   
  564.    
  565. Error allocating memory.   
  566.     General error indicating that not enough memory and/or system    
  567.     resources exist to accomplish a particular task.  Close one or    
  568.     more applications and retry the operation.   
  569.    
  570. Error renaming Fileset.   
  571.     The fileset could not be renamed.  Check your rights.   
  572.    
  573. Error updating: <name>.   
  574.     Unable to write to the fileset.  Check your rights.   
  575.    
  576. Insufficient memory available to compress files.  Close one or more    
  577. applications and try again.   
  578.     Close one or more applications to free system resources/memory.   
  579.    
  580. Name cannot be left empty.   
  581.     You must enter a valid name for a fileset, script, or scope.   
  582.    
  583. The fileset path is invalid.  Only a valid network drive may be chosen.   
  584.     You cannot store filesets on your local hard drive because your    
  585.     users who run SDUPDATE will not be able to locate them.  Store all    
  586.     filesets in a location from which all users have access.   
  587.    
  588. There are no log entries to display.   
  589.     No users have run SDUPDATE for this package yet.   
  590.    
  591. This Fileset cannot be deleted because it is part of a scheduled package.   
  592.     This Scope cannot be deleted because it is part of a scheduled    
  593.     package.   
  594.    
  595. This Log entry cannot be deleted because it is part of a scheduled package.   
  596.     This Script cannot be deleted because it is part of a scheduled    
  597.     package.   
  598.    
  599. You must first delete any packages a scope, script fileset or log entry    
  600. is part of before deleting that item. This scope has been deleted.   
  601.     This scope was deleted (probably by another user) before you    
  602.     attempted to edit it.   
  603.        
  604. Unable to delete "<name>".   
  605.     The fileset could not be deleted.  Check your rights.   
  606.    
  607. Unable to determine Fileset name. You may be running low on memory.   
  608.     Close one or more applications to free up system resources/memory.   
  609.    
  610. Unable to locate inventory equipment record.  This node has probably been    
  611. deleted.   
  612.     Another user probably deleted the specified user from your baseline.   
  613.    
  614. Unable to open source file.   
  615.     Could not open the source fileset for copy.  Check that it exists    
  616.     and that you have the appropriate rights.   
  617.    
  618. Unable to read files in this Fileset.  The Fileset is probably corrupted.   
  619.     An unexpected 'End Of File' was encountered in the fileset.     
  620.     Delete the fileset and create it again.  This fileset was corrupted.   
  621.    
  622. Write error while compressing fileset.  Check to be sure that you have    
  623. sufficient rights and enough disk space.   
  624.     The fileset could not be compressed.  Check your rights and    
  625.     available disk space.   
  626.    
  627. You cannot delete a package that is active.   
  628.     Deactivate the package, and then delete it.   
  629.    
  630. You must create a Scope before you can save a package.   
  631.     Because a package must consist of one scope, at least one scope    
  632.     must be created before creating a package.   
  633.    
  634. You must select a Fileset and/or a script for this package.   
  635.     Select either a fileset and/or a script to run for this package.   
  636.    
  637. You must select a Scope that has at least one node.   
  638.     A scope of at least one node is required in order to save a package.   
  639.    
  640. You must specify a default installation path.   
  641.     You must specify a path in which to install the fileset and to    
  642.     which the [TARGET] system variable should default.   
  643.    
  644.    
  645. 29.5 Software Distribution Update Program Error Messages   
  646.    
  647. The following error messages may display while running BrightWorks'    
  648. distribution Update program (SDUPDATE.EXE).  The messages are listed in    
  649. error number order.   
  650.    
  651.    
  652. ERROR 0101: Error determining boot drive letter.   
  653.     This is an internal DOS error.  You may be using an old DOS version.     
  654.     DOS 3.x is required.   
  655.    
  656. ERROR 0103: Error determining first available network drive.   
  657.     Check the connection to the file server, and retry the operation.   
  658.    
  659. ERROR 0104: Error determining first available hard drive.   
  660.     This is an internal DOS error.  You may be using an old DOS version.     
  661.     DOS 3.x is required.   
  662.    
  663. ERROR 0105: Not enough memory to create system variable: <VariableName>.   
  664.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  665.    
  666. ERROR 0106: There is no Inventory Site in the specified drive.   
  667.     Before a package can be installed, you must run EQUIP on the    
  668.     workstation which is to receive the distributed package.  You    
  669.     must also run an audit to include that workstation in the baseline.     
  670.     Be sure that you are specifying the proper path to the BrightWorks    
  671.     inventory database file.   
  672.    
  673. ERROR 0107: Floppy Disk Error: XX   
  674.     Check that the disk is in the drive, is write enabled, and is    
  675.     formatted properly.   
  676.    
  677. ERROR 0108: Drive 'X:' not ready or invalid drive.   
  678.     Check that the disk is in the drive, is write enabled, and is    
  679.     formatted properly.   
  680.    
  681. ERROR 0109: EQUIP needs to be run first, or your disk is write protected.   
  682.     Before a package can be installed, you must run EQUIP on the    
  683.     workstation which is to receive the distributed package.  You    
  684.     must also run an audit to include that workstation in the baseline.     
  685.     Be sure that you are specifying the proper path to the BrightWorks    
  686.     inventory database file.   
  687.    
  688. ERROR 0110: This PC isn't in the Fusion Inventory database!.  Be sure to    
  689. run an audit prior to running SDUPDATE!"   
  690.     Before a package can be installed, you must run EQUIP on the    
  691.     workstation which is to receive the distributed package.  You    
  692.     must also run an audit to include that workstation in the    
  693.     baseline.  Be sure that you are specifying the proper path to the    
  694.     BrightWorks inventory database file.   
  695.    
  696. ERROR 0111: There is no drive letter specified in default path: <Path>   
  697.     The default path that was specified for this package is invalid.     
  698.     It must be in the form of "d:\[path]", "SERVER/VOLUME:\[path]",    
  699.     "VOLUME:\[path]", or one of the pre-defined system variables present    
  700.     in the combobox.  D:\ is the drive letter, and [path] is the    
  701.     optional path.  The user running SDUPDATE must be attached to SERVER,    
  702.     VOLUME must be a valid volume on that server, and the user must    
  703.     have rights to that volume.   
  704.    
  705. ERROR 0112: An invalid drive letter was specified in default path: <Path>   
  706.     The default path that was specified for this package is invalid.     
  707.     It must be in the form of "d:\[path]", "SERVER/VOLUME:\[path]",    
  708.     "VOLUME:\[path]", or one of the pre-defined system variables present    
  709.     in the combobox.  D:\ is the drive letter, and [path] is the    
  710.     optional path.  The user running SDUPDATE must be attached to SERVER,    
  711.     VOLUME must be a valid volume on that server, and the user must have    
  712.     rights to that volume.   
  713.    
  714. ERROR 0113: Determining drive mapping to SERVER/USER in default path: <Path>   
  715.     The default path that was specified for this package is invalid.     
  716.     It must be in the form of "d:\[path]", "SERVER/VOLUME:\[path]",    
  717.     "VOLUME:\[path]", or one of the pre-defined system variables present    
  718.     in the combobox.  D:\ is the drive letter, and [path] is the optional    
  719.     path.  The user running SDUPDATE must be attached to SERVER, VOLUME    
  720.     must be a valid volume on that server, and the user must have rights    
  721.     to that volume.   
  722.    
  723. ERROR 0114: Error creating default path: <Path>   
  724.     The default path that was specified for this package is invalid.     
  725.     It must be in the form of "d:\[path]", "SERVER/VOLUME:\[path]",    
  726.     "VOLUME:\[path]", or one of the pre-defined system variables present    
  727.     in the combobox.  D:\ is the drive letter, and [path] is the    
  728.     optional path.  The user running SDUPDATE must be attached to SERVER,    
  729.     VOLUME must be a valid volume on that server, and the user must have    
  730.     rights to that volume.   
  731.    
  732. ERROR 0115: Not attached to file server: <ServerName>   
  733.     The user running SDUPDATE must be attached to the server.   
  734.    
  735. ERROR 0116: NetWare error: 0xXXXX   
  736.     NetWare error.  Check connection to server, and verify your rights.   
  737.    
  738. ERROR 0117: Invalid SERVER/VOLUME format in default path: <pathname>   
  739.     The default path that was specified for this package is invalid.     
  740.     It must be in the form of "d:\[path]", "SERVER/VOLUME:\[path]",    
  741.     "VOLUME:\[path]", or one of the pre-defined system variables present    
  742.     in the combobox.  D:\ is the drive letter, and [path] is the    
  743.     optional path.  The user running SDUPDATE must be attached to SERVER,    
  744.     VOLUME must be a valid volume on that server, and the user must have    
  745.     rights to that volume.   
  746.    
  747. ERROR 0118: No such volume: <VolumeName>   
  748.     The update program is unable to locate the specified volume.  Be    
  749.     sure the user running SDUPDATE has rights to the volume and that the    
  750.     volume exists.   
  751.    
  752. ERROR 0119: There are no available drive letters to map a drive to.   
  753.     The user running SDUPDATE's drive map table is full.  Delete one or    
  754.     more drive mappings for this user.   
  755.    
  756. ERROR 0120: Windows must be in your path to install this package.  Aborting    
  757. package install.   
  758.     This package requires that SDUPDATE can locate Windows in order to    
  759.     install.  Add the Windows directory to your path.   
  760.    
  761. ERROR 0121: Unable to open Fileset: <FilesetName>   
  762.     Could not open the fileset.  It was either deleted or the user has    
  763.     no rights to the fileset path.   
  764.    
  765. ERROR 0122: Unable to allocate buffers for Fileset: <FilesetName>    
  766.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  767.    
  768. ERROR 0123: File <FilesetName> is not a valid fileset!   
  769.     SDUPDATE found the file, but it is not a valid fileset.  From the    
  770.     BrightWorks console, choose the Fileset command from the Tools menu    
  771.     to create and edit filesets.   
  772.    
  773. ERROR 0124: Unable to create file: <FileName>   
  774.     Could not create a file.  Check your rights and the available disk    
  775.     space.   
  776.    
  777. ERROR 0125: Error in Fileset: <FilesetName>   
  778.     An unexpected End of File was encountered in the fileset.  Delete    
  779.     the fileset and create it again.  This fileset was corrupted.   
  780.    
  781. ERROR 0126: Script "<ScriptName>" has not been compiled!   
  782.     The script for this package was modified and attempted to have    
  783.     been compiled, but the compile failed.    
  784.    
  785. ERROR 0127: File <filename> doesn't exist or isn't in path.   
  786.     Could not locate the specified file.   
  787.    
  788. ERROR 0128: Out of memory.   
  789.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  790.    
  791. ERROR 0129: Out of disk space decompressing: <FilesetName> to <DefaultPath>."   
  792.     Out of space while decompressing the fileset.  This test is done    
  793.     before any files are decompressed.   
  794.    
  795. ERROR 0201: Unable to initialize Btrieve handler.   
  796.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  797.    
  798. ERROR 0204: Unable to locate script data file: <ScriptFile>!   
  799.     The compiled script file could not be located.  It was probably    
  800.     deleted.  Re-compile the script.   
  801.    
  802. ERROR 0206: The script failed on line XX.   
  803.     This message displays any time the script fails while executing.     
  804.     The message references the line number on which the script failed.   
  805.    
  806. ERROR 0211: <FunctionName> didn't have enough memory to create a variable.   
  807.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  808.    
  809. ERROR 0214: Maximum nest count reached processing function: IF.   
  810.     IF...THEN functions can only be nested 50 levels deep.   
  811.    
  812. ERROR 0216: Invalid drive letter specified in function: <FunctionName>   
  813.     A valid path is: "d:\path" where d is a valid drive letter and    
  814.     path is a valid path.   
  815.    
  816. ERROR 0217: Invalid path specified in function: <FunctionName>.   
  817.     A valid path is: "d:\path" where d is a valid drive letter and    
  818.     path is a valid path.   
  819.    
  820. ERROR 0218: Function UPGRADEOS requires DOS boot files on your boot disk!   
  821.     The disk in your boot drive does not have any DOS system files.     
  822.     These files are necessary for the UPGRADEOS function to proceed.   
  823.    
  824. ERROR 0219: Function UPGRADEOS needs the DOS files to perform the upgrade.   
  825.     Be sure to run EQUIP on a DOS 5.0 workstation, a DOS 6.0 workstation,    
  826.     and a DOS 6.2 workstation prior to using the UPGRADEOS function for    
  827.     that DOS version.  EQUIP picks up DOS system information and saves    
  828.     it in the path where the inventory databases are located, so    
  829.     SDUPDATE can find them and use them to upgrade. You should also be    
  830.     sure you have the appropriate license for the DOS version you are    
  831.     installing.   
  832.    
  833. ERROR 0220: Out of memory in function: <FunctionName>   
  834.     Ran out of memory.  Unload some TSRs and/or device drivers.   
  835.    
  836. ERROR 0221: UPGRADEOS was unable to delete system files from your boot disk.   
  837.     The boot disk is probably write protected or missing from the drive,    
  838.     or there is a problem with the drive.   
  839.    
  840. ERROR 0222: DOS version X.XX is already installed on your system!   
  841.     The DOS version to be installed on your boot disk is already running    
  842.     on the user's machine.   
  843.    
  844. ERROR 0223: UPGRADEOS error upgrading system files to boot disk.   
  845.        
  846. ERROR 0224: UPGRADEOS: Unable to reset disk controller.   
  847.    
  848. ERROR 0225: UPGRADEOS: Unable to read boot sector on boot disk.   
  849.    
  850. ERROR 0226: UPGRADEOS: Unable to write boot sector to boot disk.   
  851.    
  852. ERROR 0227: UPGRADEOS: Unable to read boot sector image file.   
  853.    
  854. ERROR 0228: UPGRADEOS Error 'XX' opening: <FileName>   
  855.     The boot disk is probably write protected or missing from the drive,    
  856.     or there is a problem with the drive.   
  857.    
  858. ERROR 0229: <FunctionName> returned error code: XX.   
  859.     A script function returned an error in [RETVAL], and the report    
  860.     non-zero return codes option was checked for this package.   
  861.    
  862.    
  863.    
  864. 30.0 Troubleshooting 
  865. This section describes solutions to some of the common difficulties 
  866. encountered with SiteMeter.
  867.  
  868. 30.1 Installation and Set Up
  869.  
  870. Please see the Quick Start Guide in metering.txt for instructions on 
  871. installation and setup. Chapter 2 in Intro.txt provides detailed 
  872. installation instructions and error messages.
  873.  
  874.  
  875. 30.2 Cannot Meter
  876.  
  877. This section provides a checklist of things to do if you are unable to meter 
  878. software on your network. An example of this problem would be when a user 
  879. runs an application but SiteMeter does not show the software as active in 
  880. View Application Usage or in the Usage.exe program.
  881.  
  882. Follow the items on this checklist:
  883. 1.  Check if the NLMs are loaded and active.  If the user cannot meter a 
  884.     Windows based program, also check if SMRAGENT is loaded.  Go into 
  885.     Administration, Metering, View Metering Status.
  886.  
  887. 2.  Try placing a full path into the filename field when defining the 
  888.     metered application.  If that does not work, try without a path and just 
  889.     a filename.
  890.  
  891. 3.  Check if the NetWare drivers are up to date (at a minimum they should be 
  892.     IPX v. 3.10,  NETX v. 3.26,  IPXODI v. 2.10, LSL v. 2.01).
  893.  
  894. 4.  If the user is loading SWATCHER, make sure it is loaded low.  Swatcher 
  895.     is only designed to be loaded into conventional memory (640 K).  
  896.  
  897. 5.  Check for additional, interfering TSRs or drivers.  Do a MEM /C | MORE 
  898.     to see what is loaded in memory and strip the PC of all TSR's and 
  899.     drivers besides the NetWare drivers and whatever is absolutely necessary 
  900.     for Windows.  
  901.  
  902.     To do this, rename the autoexec.bat file to autoexec.old and remove from 
  903.     the config.sys file all unnecessary drivers.  For instance, WordPerfect 
  904.     Office v. 3.1's Notify TSR may prevent a DOS application from releasing 
  905.     the lockset.
  906.  
  907. 6.  Check the win.ini file's load= statement.  Test with only SMRAGENT and 
  908.     NWPOPUP on the load= statement.
  909.  
  910. 7.  SPAWNING.  Check if the file that is being metered is SPAWNING.  A file 
  911.     that spawns opens up one file, closes it and then opens up a different 
  912.     file.  
  913.  
  914.     For example, WordPerfect For Windows v. 5.1 first opens WPWIN.EXE.  It 
  915.     then closes WPWIN.EXE and opens or spawns to WPWINFIL.EXE.  This means 
  916.     that WPWINFIL.EXE is the file to meter for WordPerfect For Windows.  To 
  917.     check for what file to meter, run RCONSOLE or walk over to the fileserver 
  918.     console.  Run Monitor.  Then List Active Connections and select 
  919.     Connection Information.  
  920.  
  921.     Select the name of the user.  Then have the user run the application.  
  922.     The files that remain open in Monitor for that user's PC will be 
  923.     displayed and you will be able to identify the files running for the 
  924.     application.  
  925.  
  926.     As of this writing, SiteMeter v. 4.1.1 or earlier requires that an .exe 
  927.     or .com file must be open in order to meter an application.  The 
  928.     secondary file or files that are spawned may not have an .exe or .com 
  929.     extension and this sometimes results in the application not metering or 
  930.     the lockset not being released when the application is closed.  If this is 
  931.     the case and the application is a DOS based program, SLOCK and SUNLOCK may 
  932.     be used to meter the program.  SLOCK and SUNLOCK are metering utilities 
  933.     which shipped with SiteLock.  Simply create a batch file which runs SLOCK, 
  934.     the DOS application and then SUNLOCK.  For example, let's say the program 
  935.     is SYSCON.  The .bat file that would be set up could be called SYSCON.BAT.  
  936.     The contents of the .bat file would be, 
  937.     SLOCK SYSCON_UTIL
  938.     SYSCON.EXE
  939.     SUNLOCK SYSCON_UTIL
  940.     where SYSCON_UTIL is the Metered Application Name in the Currently 
  941.     Metered Application under Metering.  When the user types SYSCON, 
  942.     SYSCON.BAT will execute and SLOCK will run, manually placing a lock on 
  943.     the metered application.  Then SYSCON.EXE will run.  When the user exits 
  944.     SYSCON, SUNLOCK will run, manually releasing the lock in SiteMeter.  
  945.  
  946. NOTE: Spawning will be addressed by an enhancement in a future release of 
  947. SiteMeter/BrightWorks.  Another workaround is to list all of the .exe or .com 
  948. files under File[s] To Meter in the metered application.  This sometimes 
  949. gets the application to meter properly and/or release the lockset.  
  950. Especially try this with Windows based applications because there is no 
  951. workaround like Sunlock to catch a spawned Windows based application.  
  952.  
  953.     An additional workaround is to modify the SITEMETR.EXT file.  The 
  954.     Sitemetr.ext file exists in the Home Directory For Data Files 
  955.     (SYS:SYSTEM\SITEMETR).  It contains a listing of the extensions of the 
  956.     files that can be accepted as the File[s] To Meter in a metered 
  957.     application.  By editing this file, the Supervisor (or equivalent) will 
  958.     then be able to enter a filename with the new file extension as a 
  959.     File[s] To Meter.  It may then be possible to meter an application 
  960.     without a .exe or .com extension.  In our experience, the only 
  961.     applications that were able to be metered this way were Micrographic 
  962.     programs.  These programs include Designer, Draw and Charisma.  These 
  963.     programs spawn to a .BIN file which SiteMeter cannot normally meter.  
  964.     The workaround for the SITEMETR.NLMs and SMRAGENT is as follows:
  965.     a. Edit the SYS:\SYSTEM\SITEMETR\SITEMETR.EXT file and add .BIN to 
  966.     the list of file extensions.
  967.     b. Enter (DESIGNER).BIN as the File[s] To Meter in the Currently 
  968.     Metered Application under SiteMeter (SYS:\DESIGNER\DESIGNER.BIN).
  969.  
  970. NOTE: For SWATCHER, the workaround to meter Micrographics programs is quite 
  971. different: Delete the original Designer.exe file and rename the Designer.bin 
  972. file to Designer.exe. Copy that new .EXE  file into the <MGXLIBS> 
  973. subdirectory. Within File[s] To Meter include the specific path and correct 
  974. .EXE file to protect. Other programs such as Draw and Charisma can do the 
  975. same. Rename or delete the .EXE file and copy the .BIN file to a .EXE file.
  976.  
  977. 8.  Remove items from the Windows Startup group and test.
  978.  
  979. 9.  Reload the Sitemetr and Smrproxy NLMs.
  980.  
  981. 10. If the SiteMeter NLMs are being loaded after Macintosh NLMs 
  982.     (AFP.NLM, ATPS.NLM), load the SiteMeter NLMs before the Macintosh NLMs.  
  983.     In the past, having the SiteMeter NLMs loaded after Macintosh NLMs 
  984.     sometimes caused the fileserver to crash and/or metering to fail.
  985.  
  986. 11. Check if the old SiteLock NLM is simultaneously loaded with Sitemetr.nlm 
  987.     and Smrproxy.nlm.  This could have disastrous, random results.  If so, 
  988.     remove Sitelock.nlm.
  989.  
  990. 12. Recreate the lockset.  Go Metering, Currently Metered Applications and 
  991.     delete the entry for the software package that will not meter.  Then add 
  992.     the entry back into the metering database and retest.
  993.  
  994.  
  995. 30.3 LockSet Does Not Release
  996.  
  997. For example, a user enters Lotus 1-2-3.  After exiting the program, View 
  998. Application Usage or USAGE.EXE still shows the user in the application 
  999. when they are not in the application. 
  1000.  
  1001. To troubleshoot this situation, usually the affected PC must first release 
  1002. the lockset.  To do this, have the user with the locked application either 
  1003. back out of Windows or log out of the network. Follow this checklist to 
  1004. solve this problem:
  1005. 1.  Do one of the following:
  1006.     a.  Place the full path into the File[s] To Meter field.  For 
  1007.     example, SYS:\PUBLIC\SYSCON.EXE.  Go into Metering and Modify the 
  1008.     currently metered application.  'Remove' the file that is already 
  1009.     present and then 'Add' to Browse For Files To Meter.  Make sure the 
  1010.     Include Path box is marked.  Then browse for the filename and it 
  1011.     will appear in the File[s] To Meter window with the full path.  
  1012.     b.  If the path already exists in the File[s] To Meter field, 
  1013.     remove the path and just leave the filename using similar steps as 
  1014.     in 1a.  For example, 123.EXE. Make sure the Include Path box is blank.  
  1015.  
  1016. 2.  If the user has loaded the SWATCHER TSR, make sure that Swatcher is NOT 
  1017.     loaded high.  Swatcher was designed to only be loaded in conventional 
  1018.     memory (640 K).
  1019.  
  1020. 3.  Check if the NLMs are loaded and active.  Go Administration, Metering, 
  1021.     View Metering Status.
  1022.  
  1023. 4.  Ensure that the user has loaded the latest NetWare drivers (IPX, IPXODI, 
  1024.     LSL and NETX).
  1025.  
  1026. 5.  SPAWNING.  Check if the application spawns other files.  
  1027.  
  1028.     As of this writing, SiteMeter v. 4.1.1 or earlier requires an open .exe 
  1029.     or .com file to meter an application. This will be addressed by an 
  1030.     enhancement in a future release.  The secondary file or files that are 
  1031.     spawned may not have an .exe or .com extension and this sometimes 
  1032.     results in the lockset not being released when the application is 
  1033.     metered.  If this is the case and the application is a DOS based program, 
  1034.     SUNLOCK may be used to release the lockset.  SUNLOCK is a metering utility 
  1035.     which shipped with SiteLock.  Simply create a batch file which runs the 
  1036.     DOS application and then runs SUNLOCK.  For example, lets say the program 
  1037.     is SYSCON.  The .bat file that would be set up could be called SYSCON.BAT.  
  1038.     The contents of the .bat file would be,
  1039.     SYSCON.EXE
  1040.     SUNLOCK SYSCON_UTIL
  1041.     where SYSCON_UTIL is the Metered Application Name in the Currently 
  1042.     Metered Application under Metering.  When the user types SYSCON, 
  1043.     SYCON.BAT will execute and SYSCON.EXE will run.  When the user exits 
  1044.     SYSCON, SUNLOCK will run, manually releasing the lockset in SiteMeter.  
  1045.     Please see Appendix A for further information.
  1046.  
  1047.     Another workaround is to list all of the .exe or .com files under File[s] 
  1048.     To Meter in the metered application.  This sometimes gets the application 
  1049.     to meter properly and release the lockset.  Especially try this with 
  1050.     Windows based applications, because there is no workaround like Sunlock to 
  1051.     catch a spawned Windows based application.  
  1052.  
  1053. 6.  Check for additional, interfering TSRs or drivers.  Do a MEM /C | MORE to 
  1054.     see what has been loaded into memory and strip the PC of all TSR's and 
  1055.     drivers besides the NetWare drivers and whatever is absolutely necessary 
  1056.     for Windows.  
  1057.  
  1058.     To do this, rename the autoexec.bat file to autoexec.old and remove from 
  1059.     the config.sys file all unnecessary drivers.  For instance, WordPerfect 
  1060.     Office v. 3.1's Notify TSR may prevent a DOS application from releasing 
  1061.     the lockset.
  1062.  
  1063. 7.  Remove items from the Windows Startup group and test.
  1064.  
  1065. 8.  Check the PC's win.ini file's load= statement.  Test with only SMRAGENT 
  1066.     and NWPOPUP on the load= statement.
  1067.  
  1068. 9.  Check if the old SiteLock NLM is simultaneously loaded with Sitemetr.nlm 
  1069.     and Smrproxy.nlm.  This could have disastrous results.  If the 
  1070.     Sitelock.nlm is loaded, REMOVE the Sitelock.nlm from the fileserver's 
  1071.     memory and the autoexec.ncf file.
  1072.  
  1073. 10. Recreate the lockset.  
  1074.     
  1075.     Go Metering, Currently Metered Applications and delete the entry for the 
  1076.     software package that will not meter.  Then add the entry back into the 
  1077.     metering database and retest.
  1078.  
  1079. 11. QEMM v. 7.01.  Can't release a lockset for an application that is called 
  1080.     off an attached server due to QEMM v. 7.01.  
  1081.  
  1082.     The workaround is to remove the LOADHI command from the SHELL= line in 
  1083.     the workstation's CONFIG.SYS.  QEMM's v7.xx of Optimize places this 
  1084.     LOADHI command on the SHELL= line.  Apparently, previous versions of 
  1085.     Optimize did not do this.  
  1086.     
  1087. 12. DR DOS v. 6.0.  It is suspected that you can't release a lockset on a PC 
  1088.     running DR DOS v. 6.0.  Use a different type of DOS.  
  1089.  
  1090. 13. Check if the user is loading SMRAGENT.EXE dated 2-14-94 with a byte count 
  1091.     of 29,776.  This version of SMRAGENT had a problem releasing locksets.  
  1092.     Have the user get SMRUP2.EXE which contains the latest SMRAGENT.EXE file 
  1093.     (4-01-94).  
  1094.  
  1095. NOTE: This problem also applied to DOS applications run under Windows.
  1096.  
  1097. 14. NET-PROT.  It is possible that with the NETPROT.NLM v. 1.23 loaded, 
  1098.     intermittently locksets do not release or SiteMeter fails to meter.  
  1099.  
  1100.     Results from in-house testing revealed that locksets on DOS applications 
  1101.     are not released.  This only seems to occur if an active virus scan is 
  1102.     being performed by Net-Prot.  Locksets on Windows applications seem to 
  1103.     meter fine but will occasionally not be released.  This does not seem to 
  1104.     follow any pattern.  
  1105.     However, if an active virus scan is being performed by Net-Prot, 
  1106.     SiteMeter will NOT release locksets.  This issue is currently under 
  1107.     investigation.  
  1108.  
  1109.  
  1110. 30.4 SMRUP Patches
  1111.  
  1112. This section describes the various patches available for SiteMeter.
  1113.  
  1114. SMRNLM.EXE   73,092   6-02-94
  1115. SMRNLM.EXE only contains the current SiteMeter NLMs, current SMRAGENT.EXE 
  1116. file and the current SITEMETR.MSG file (along with a read me file SMRNLM.DOC).  
  1117. SMRNLM.EXE supports versions of SiteMeter v. 4.00 or greater.  The updated 
  1118. version of SMRAGENT.EXE included here addresses an "out of memory" message 
  1119. that could display in Windows (Occurred with SMRAGENT 3-09-94).  If a user 
  1120. needs only the current NLMs or SMRAGENT, SMRNLM.EXE is the file to use.  
  1121. *  351108  05-04-94  12:12  SITEMETR.NLM
  1122. *  21168   04-01-94  13:26  SMRAGENT.EXE
  1123. *  74972   05-04-94  12:18  SMRPROXY.NLM
  1124. *  1439    02-10-94  10:29  SITEMETR.MSG
  1125. *  3557    06-02-94             SMRNLM.DOC
  1126.  
  1127.  
  1128. Other items SMRNLM.EXE addresses:
  1129. 1.  Sometimes cannot meter or virus protect applications run from a map 
  1130. rooted drive.
  1131. 2.  SMRPROXY NLM cannot be loaded without first disabling NetWare Accounting.
  1132. 3.  The fileserver would sometimes abend upon a DOWN command.
  1133. 4.  Sometimes a SPX socket problem occurred with SMRAGENT 8-17-93.  
  1134.     This  sometimes occurred with other programs that open SPX sockets 
  1135.     inside Windows such as a mail TSR or Windows For Workgroups.  Symptoms 
  1136.     include, "SiteMeter agent Error 7:  There was an IPX Problem 
  1137.     communicating with server" or "Wcnwlib error:  Unexpected error opening 
  1138.     socket" or PC lock ups.  This problem also results in "Error 001: cannot 
  1139.     communicate with VAP or NLM" with the SiteLock Swrap feature.  
  1140. 5.  IPX Traffic.  
  1141.     Sometimes when the 7-20-93 Sitemetr.nlm and the 8-5-93 Smrproxy.nlm were 
  1142.     loaded, fileserver utilization might increase and possibly no one could 
  1143.     login.
  1144. 6.  Locksets were not released with SMRAGENT 2-14-94, byte count 29,776.
  1145. 7.  When INSTALL is loaded at the fileserver, the fileserver would sometimes 
  1146.     abend (occurred with SITEMETR.NLM 2-13-94 and SMRPROXY.NLM 2-14-94).
  1147.  
  1148. SMRUP3.EXE   05-25-94  1,788,902  11:48a
  1149. On 5-25-94 the SMRUP2.EXE patch was released.  IT IS ONLY APPLICABLE TO 
  1150. SITEMETER v. 4.10 USERS.  IT IS NOT APPLICABLE TO SITEMETER v. 4.00 USERS.  
  1151. SMRUP3 is a self-extracting file dated 5-25-94 and contains the following 
  1152. files:
  1153. *  READ1ST.TXT      9,714 05-18-94  11:27a
  1154. *  SITEMTR.EXE   1,774,855 05-17-94   5:17p
  1155.  
  1156. SITEMTR.EXE consists of the following files:
  1157. *  DPRODREG.EXE  77,437 03-18-94  2:10p; used for serialization only
  1158. *  FIELD   .DDF  55,296  04-28-94   11:27a
  1159. *  FILE    .DDF  7,680  04-28-94   11:27a
  1160. *  SITEMETR.EXE  1,175,568   05-09-94  5:54p
  1161. *  FUSION  .CFG  55   11-15-93  7:05p; used for serialization only
  1162. *  INDEX   .DDF  11,776   04-28-94   11:27a
  1163. *  NWCALLS .DLL  146,544   11-02-93   2:30p
  1164. *  NWIPXSPX.DLL  38,544   11-02-93   5:47p
  1165. *  NWLOCALE.DLL  38,576   11-02-93   6:12p
  1166. *  NWNET   .DLL  205,104   11-02-93   5:12p
  1167. *  NWNETAPI.DLL  106,884   01-07-93   1:31p
  1168. *  SERIAL  .BAT  32   03-17-94   4:33p; used for serialization only
  1169. *  SITEMETR.NLM  351,108   05-04-94   12:12p
  1170. *  SMRAGENT.EXE  21,168   04-01-94   1:26p
  1171. *  SMRPROXY.NLM  74,972   05-04-94   12:18p
  1172. *  US_AD   .RPT  17,008   03-22-94   4:57p
  1173. *  VENDOR  .LIS  1,745   03-31-93   11:36a
  1174. *  UFLBWRKS.DLL  32,640   05-03-94   05:03p
  1175. *  CHISHWSV.RPT  25,951   05-04-94   02:51p
  1176. *  CHISHWMC.RPT  23,809   05-04-94   03:03p
  1177. *  CHISHWPC.RPT  25,423   05-04-94   11:05a
  1178. *  UPF     .RPT  9,562   03-22-94   04:39a
  1179. *  US      .RPT  14,949   03-22-94   04:44p
  1180. *  US_AS   .RPT  15,853   03-24-94   04:05p
  1181. *  SPA     .RPT  7,942   03-22-94   04:35p
  1182. *  SWINAPP .EXE  49,680   05-04-94   12:06p
  1183. *  SREPORT .EXE  116,752   05-09-94   05:30p
  1184. *  SYSMOD  .EXE  44,192   05-04-94   12:08p
  1185. *  USAGE   .EXE  130,064   05-04-94   01:44p
  1186. *  SDUPDATE.EXE  136,736   05-04-94   11:55p
  1187. *  SA_EQUIP.EXE  272,421   05-02-94   04:35p
  1188. *  WSDUPD  .EXE  21,504   05-04-94   12:03p
  1189. *  EQUIP   .EXE  174,607   05-02-94   04:17p
  1190. *  CRW     .EXE  1,768,448   05-04-94   04:56p
  1191. *  QUICKST .WRI  17,536   05-09-94   10:37a; a guide to getting started
  1192. *  DELID   .EXE  16,318   05-04-94   11:35a
  1193. *  SPF     .RPT  9,622   03-22-94   04:38p
  1194. *  AS_UD   .RPT  18,218   03-22-94   03:36p
  1195. *  AS      .RPT  14,318   03-22-94   03:38p
  1196. *  AS_US   .RPT  16,592   03-22-94   04:13p
  1197. *  WSREPOT .RPT  26,961   04-22-94   04:51p
  1198. *  METERDEF.RPT  7,416   03-23-94   05:03p
  1199. *  BDIABOUT.DLL  424,464   05-11-94   12:34p
  1200. *  SMRXPORT.DLL  67,628   04-17-94   04:46p
  1201. *  README  .TXT  36,144   05-13-94   01:37p; updated with the new changes
  1202. *  SMR     .BAT  158   05-17-94   02:26p; to remove old files
  1203.  
  1204. SITEMTR.EXE contains updated NLMs, DLLs, and EXEs for BrightWorks v1.0.1, LAN 
  1205. Inventory 3.1.1 and SiteMeter v4.1.1.  (Please note that the NLMs and 
  1206. SMRAGENT.EXE included here are the same versions of those files that are 
  1207. contained within FUSUP3.EXE of PCVEND LIB3).  The updated version of 
  1208. SMRAGENT.EXE included here addresses an "out of memory" message that could 
  1209. display in Windows (Occurred with SMRAGENT 3-09-94).  Also included in 
  1210. SITEMTR.EXE are updated Data Dictionaries (DDFs).  These DDFs now combine 
  1211. Inventory and Metering data structures into the same group of definition 
  1212. files.  In addition, an update to the canned Metering report "Application 
  1213. Use with User Detail" (US_AD.RPT) addresses an issue wherein the Date could 
  1214. appear in the Time Out field. It also includes an updated message file for 
  1215. the SiteMeter NLMs.  The following list details what other fixes are 
  1216. included in this patch.  These errors sometimes occurred with SiteMeter v. 4.0 
  1217. and the patches released up to, but not including, SiteMeter v. 4.1:
  1218.  
  1219. 1.  Sometimes cannot meter or virus protect applications run from a map 
  1220.     rooted drive.
  1221. 2.  SMRPROXY NLM cannot be loaded without first disabling NetWare Accounting.
  1222. 3.  The fileserver would sometimes abend upon a DOWN command.
  1223. 4.  Sometimes a SPX socket problem occurred with SMRAGENT 8-17-93.  
  1224.     This sometimes occurred with other programs that open SPX sockets inside 
  1225.     Windows such as a mail TSR or Windows For Workgroups.  Symptoms include, 
  1226.     "SiteMeter agent Error 7:  There was an IPX Problem communicating with 
  1227.     server" or "Wcnwlib error:  Unexpected error opening socket" or PC lock 
  1228.     ups.  This problem also results in "Error 001: cannot communicate with 
  1229.     VAP or NLM" with the SiteLock Swrap feature.  
  1230. 5.  IPX Traffic.  Sometimes when the 7-20-93 Sitemetr.nlm and the 8-5-93 
  1231.     Smrproxy.nlm were loaded, fileserver utilization might increase and 
  1232.     possibly no one could login.
  1233. 6.  Locksets were not released with SMRAGENT 2-14-94, byte count 29,776.
  1234. 7.  When INSTALL is loaded at the fileserver, the fileserver would sometimes 
  1235.     abend (occurred with SITEMETR.NLM 2-13-94 and SMRPROXY.NLM 2-14-94).
  1236.  
  1237. SiteMeter v. 4.1.1 contains these updated files:
  1238. *  SMRPROXY.NLM  74,972   5-04-94
  1239. *  SITEMETR.NLM  351,108   5-04-94
  1240. *  SMRAGENT.EXE  21,168   4-01-94
  1241. *  SITEMETR.MSG  1,439   2-10-94 
  1242.  
  1243.  
  1244. 30.5 SiteMeter Reports (Sreport.exe)
  1245. As of this writing, SREPORT.EXE 5-9-94, 116,752 bytes is the current 
  1246. SiteMeter Report file.  It ships with SiteMeter v. 4.1.1.  It is available 
  1247. in a patch file SMRRPT3.EXE which is on Compuserve, GO BRIGHT, LIB 3.  
  1248.  
  1249. 1.  "Sreport caused a GPF in module DLWBC31.DLL".  
  1250.     A General Protection Fault error occurs when a user Exports a 65K or 
  1251.     greater Sitedata file to non-btrieve format (i.e., Excel, etc.).  This 
  1252.     is an open issue currently under investigation.  To workaround the 
  1253.     issue, rename the Sitedata file before it reaches 65K in size.
  1254.  
  1255. 2.  Btrieve error code 20, cannot run Sreport".  
  1256.     This means that SREPORT.EXE detected that Btrieve was not loaded 
  1257.     properly.
  1258.     a.  Local Btrieve or brequest.exe are INDEED not loaded.
  1259.     b.  SPX is not loaded (when using brequest and server btrieve.  
  1260.     IPXODI has the option of disabling SPX. Enable SPX).  Make sure 
  1261.     IPXODI is NOT loaded with a  /d or /a switch.  /d prevents IPXODI 
  1262.     from loading SPX.  
  1263.     c.  BSPXCOM.NLM is not loaded.
  1264.     d.  Ensure that VIPX.386 is version 1.17 or later if IPXODI is being 
  1265.     loaded high.  If VIPX.386 is version 1.1 and IPXODI is loaded high, 
  1266.     the SPX could fail and cause the BTRIEVE error 20.
  1267.     e.  Make sure the NOVDB.INI file exists in the \Windows directory.
  1268.     f.  If the user is attached to multiple fileservers, have them log 
  1269.     into just the one server where SiteMeter/BrightWorks is installed.
  1270.  
  1271. 3.  Sreport caused a GPF in module CRPE.DLL @ 0026:0A03".  
  1272.     Resolved by SREPORT 5-9-94, byte count 116,752.  Get SMRUP3.EXE file 
  1273.     from Compuserve.
  1274.  
  1275. 4.  No information shows in a SiteMeter report done for a date range of 
  1276.     one day.  
  1277.     For a workaround,  do a report with a date range greater than one day.  
  1278.     This is an open issue that is currently being investigated.  
  1279.  
  1280. 5.  Peaks calculation problem.  
  1281.     Resolved by SREPORT 5-9-94, byte count 116,752.  Get SMRUP3.EXE file 
  1282.     from Compuserve.
  1283.  
  1284. 6.  "Unanticipated Btrieve Error #1".  
  1285.     User gets this error if they use Brequest v. 6.10d.  This error also 
  1286.     occurs with BREQUEST.EXE v6.10e.  
  1287.     Use Brequest v. 6.10c, or later, instead.  Btrieve v. 6.10c is available 
  1288.     on Compuserve.  GO NOVLIB, Library 7 and download the file BTR61.EXE.
  1289.  
  1290. 7.  Negative number problem.  
  1291.     User gets negative numbers in the report data.  First addressed by 
  1292.     SREPORT 3-24-94.  Get SMRUP3.EXE file from Compuserve.
  1293.  
  1294. 8.  An update to the "canned" report file US_AD.RPT resolved an issue wherein 
  1295.     the Date could appear in the "Time Out" field of the "Application Use 
  1296.     with User Detail" report.  
  1297.     First addressed on 3-15-94.  Get SMRUP3.EXE file from Compuserve.
  1298.  
  1299. 9.  The "Defined Limit" field of the Metering Definitions could reflect an 
  1300.     incorrect value.  
  1301.     First resolved with 3-24-94 Sreport.  Get SMRUP3.EXE file from Compuserve.
  1302.  
  1303. 10. A GPF that could be caused by UFLSAMP1.DLL.  
  1304.     First resolved with Sreport 3-24-94.  Get SMRUP3.EXE file from 
  1305.     Compuserve.
  1306.  
  1307. 11. The SMRPT2.EXE file included updated .dll files so as to be in sync with 
  1308.     the same files that existed in the Fusion v1.00 package and in 
  1309.     FUSUP2.EXE patch file on Compuserve, LIB3, PCVEND.  
  1310.     SMRUP3.EXE patch contains these files as well.
  1311.  
  1312. 12. GPF caused by UNIDRV.DLL.  
  1313.     SiteMeter reports would give a GPF in UNIDRV.DLL when the Printer Icon 
  1314.     was used to print from an open report window and the user then exited and 
  1315.     re-entered the SiteMeter reports.  This is an OPEN issue.  The workaround 
  1316.     is to either close all of the open report windows before exiting 
  1317.     SiteMeter Reports or to have the user downgrade to an earlier version of 
  1318.     UNIDRV.DLL.
  1319.  
  1320. 13. Corrupt Sitedata file?  
  1321.     When the SiteMeter Reports fail, another possibility is that the 
  1322.     SITEDATA file has become corrupt (or SITEDATA does not exist because no 
  1323.     one has been metered yet and caused SITEDATA to be created by the NLMs).  
  1324.     A quick method of verifying this is to divide the byte size of the 
  1325.     Sitedata file by 49.  If the result is not a round number, the file is 
  1326.     corrupt.  The Sitedata Debugger program may be used to fix the file.  To 
  1327.     have the Debugger come up in SREPORT, create a SREPORT.INI file in the 
  1328.     \WINDOWS directory.  It should contain,
  1329.     [Debug]
  1330.     Enabled=1
  1331.     file type=10
  1332.     An alternative is to send the Sitedata file to McAfee East Tech Support 
  1333.     by Compuserve or the mail so we can fix it with the Sitedata 
  1334.     Debugger program.  
  1335.  
  1336.  
  1337. 30.6 BTRIEVE
  1338. This section contains common SiteMeter Btrieve errors and solutions.
  1339. 1.  "Btrieve record manager inactive".  
  1340.     Have the user type PATH.  This will show all of their search drives.  
  1341.     Then have the user do a dir on WBTRCALL.DLL in each of the search drives.  
  1342.     If they come across another copy of WBTRCALL.DLL it means the user may 
  1343.     be loading the wrong WBTRCALL.DLL file for Btrieve.
  1344.  
  1345. 2.  User runs the SiteMeter reports and gets "Unable to allocate memory for 
  1346.     Btrieve".  
  1347.     This error is caused by not having enough free conventional memory.  
  1348.     a.  Load BREQUEST in the WINSTART.BAT file so it does not load in 
  1349.     conventional memory.
  1350.     b.  Free up some conventional memory and restart (i.e. remove TSRs, 
  1351.     etc.).  It has been reported that about 508K of free memory is 
  1352.     needed to run the SiteMeter Reports.
  1353.  
  1354. 3.  User runs the SiteMeter Reports and gets "Page Size Error - Btrieve 
  1355.     error 24".  
  1356.     a.  The user must run BREQUEST or BTRIEVE at the workstation.
  1357.     b.  Free up memory.  Load items high (LSL, NIC driver, etc.) and/or 
  1358.     load BREQUEST into high memory by loading it in the WINSTART.BAT file.  
  1359.  
  1360.  
  1361. 30.7 SiteMeter Agent
  1362. This section describes what to do if you get the following error:
  1363. SITEMETER AGENT ERROR 10:  CURRENT VERSION OF THE NETWARE API DLLS IS NOT 
  1364. FULLY COMPATIBLE WITH IPX DRIVER LOADED.  UNABLE TO LOAD.
  1365.  
  1366. 1.  SMRAGENT requires the NetWare drivers to be loaded in order to load.  
  1367.     Ensure that that at least the following versions, at a minimum, are 
  1368.     loaded:
  1369.     *  IPX           3.10
  1370.     *  NETX       3.26
  1371.     *  IPXODI     2.10
  1372.     *  LSL          2.01
  1373.  
  1374. 2.  If TBMI or TBMI2 is loaded the problem may occur (TBMI may be loaded 
  1375.     for IBM 3270 emulation).  
  1376.  
  1377. 3.  If the user has not loaded the network drivers, r.e. laptop PCs, the 
  1378.     error may occur.
  1379.  
  1380. 4.  Xircom pocket adapters may fail with SMRAGENT.  
  1381.  
  1382. 5.  May be bringing up Windows in Standard Mode (check Program Manager, Help, 
  1383.     About).  Bring up Windows in 386 Enhanced mode.
  1384.  
  1385. 6.  Check if the user is loading TSR's for the Compustat Financial Services 
  1386.     database CD ROM:  NETUIPX.COM, WNETQSR.COM & MSCDEX.EXE.  Have them load 
  1387.     swatcher and Swinapp on the PC instead of smragent.
  1388.  
  1389. 7.  Check if VIPX.386 exists on the network= line of the SYSTEM.INI file.  
  1390.     Under the [386 Enh] section.
  1391.  
  1392. 8.  If all else fails, have the user try re-installing Windows for that PC.
  1393.  
  1394.  
  1395. 30.7 Changing the SiteMeter Messages
  1396.  
  1397. A user may request to change the text of a message in SiteMeter.  The method 
  1398. to do this is to go into the SYS:SYSTEM\SITEMETR directory (or wherever the 
  1399. Home Directory For Data Files are located.  Go Administration, Metering, 
  1400. Configuration Options).  Then have the user make a backup of the SITEMETR.MSG 
  1401. file.  They can then use a text editor to change the messages.  Then the user 
  1402. must reload the SiteMeter NLMs.
  1403.  
  1404.    
  1405.  
  1406. 31.0 Equipment Database   
  1407.    
  1408. This appendix discusses and provides examples of the following:   
  1409.    
  1410. o  equipment inventory record types and their contents   
  1411. o  information collected by the EQUIP.EXE program    
  1412.    
  1413.    
  1414. 31.1 Equipment Inventory Records   
  1415.    
  1416. Equipment inventory records are displayed by choosing the Inventory    
  1417. command from the View menu.  The detailed inventory information that    
  1418. displays for each record depends on the record type.  Record types consist    
  1419. of file server, MAC, PC workstation, and spare parts.  The fields    
  1420. displayed for each type are listed below:   
  1421.    
  1422. o  Fields Displayed For File Servers   
  1423.     - Computer Information (Serial Number, Network Operating System,    
  1424.     CPU, Memory)   
  1425.     - Volumes   
  1426.     - Physical Drives   
  1427.     - LAN Adapter Information   
  1428.     - Software Applications   
  1429.     - Miscellaneous Equipment   
  1430. o  Fields Displayed For MACs   
  1431.     - Computer Information (Appletalk Version, CPU, Finder Version,    
  1432.     Floating Point Unit, Keyboard, Memory, Model, ROM Size, ROM Version,    
  1433.     System Version)   
  1434.     - Slot Adapter/Drivers   
  1435.     - Monitors   
  1436.     - Floppy Drives   
  1437.     - Mounted Volumes   
  1438.     - SCSI Devices   
  1439.     - Software Applications   
  1440.     - Miscellaneous Equipment   
  1441. o  Fields Displayed For PC Workstations   
  1442.     - Computer Information (Model, Bios, Bios Date, Brand, BUS, CMOS,    
  1443.     Clock Frequency, CPU, Operating System and Version)   
  1444.     - Mass Storage   
  1445.     - Keyboard/Display   
  1446.     - Ports   
  1447.     - Network Adapter   
  1448.     - Memory   
  1449.     - Software Applications   
  1450.     - System Files   
  1451.     - Miscellaneous Equipment   
  1452. o  Fields Displayed For Spare Parts   
  1453.     - Computer Information (Memory, CPU, Serial Number, Network    
  1454.     Operating System)   
  1455.     - Miscellaneous Information   
  1456.        
  1457.    
  1458.    
  1459.    
  1460. 32.0 Using Brequest   
  1461.    
  1462. This appendix discusses the use and configuration of the server-based    
  1463. Btrieve record manager, BREQUEST.   
  1464.    
  1465. 32.1 Using the Btrieve NLM   
  1466.    
  1467. The Btrieve record manager must be loaded before running the BrightWorks    
  1468. EQUIP program.  It is highly recommended that you use the server-based    
  1469. BREQUEST program while running EQUIP.  This appendix offers recommendations    
  1470. on setting up and using the Btrieve NLM.    
  1471.    
  1472. NOTE:  a - When using BREQUEST, version 6.10 or greater is required.   
  1473. b -  When using BREQUEST, BSPXCOM must also be loaded on the    
  1474. fileserver.  For details on loading these programs, refer to your Novell    
  1475. documentation.   
  1476.    
  1477.    
  1478. 32.1.1 Using the NLM with EQUIP   
  1479.    
  1480. Using BREQUEST, as opposed to BTRIEVE, will improve the performance of    
  1481. data collection, auditing and reporting by at least 50% and as much as 500%.     
  1482. An additional advantage is the savings in local (client) memory*BTRIEVE.EXE    
  1483. can occupy from 50-85K of conventional memory, whereas BREQUEST.EXE can    
  1484. occupy approximately 31-45K.  The exact amount of memory required for both    
  1485. programs depend on the specified command line parameters.   
  1486.    
  1487. Use the following procedure to configure the Btrieve NLM.   
  1488.    
  1489. 1.  To configure the NLM, run BSETUP.NLM.   
  1490.    
  1491.     At the file server console prompt, type:   
  1492.    
  1493.     LOAD BSETUP <ENTER>   
  1494.    
  1495. 2.  Choose Set Btrieve Configuration to verify that the following options   
  1496.     are defined.   
  1497.    
  1498.     The values provided below are the minimum values required; your    
  1499.     current values may be set higher.   
  1500.    
  1501.     o  Number of Open Files: = 22  (default = 20)   
  1502.     o  Number of Transactions: = 1  (default = 0)   
  1503.     o  Largest Record Size: = 17000  (default = 8192)   
  1504.     o  Largest Page Size: = 4096  (default = 4096)   
  1505.    
  1506. NOTE:  All other BSETUP options can remain unchanged.   
  1507.    
  1508. 3.  Save the configuration, and exit BSETUP.   
  1509.    
  1510.     BSETUP writes the configuration changes to the BSTART.NCF file.  The    
  1511.     changes do not take effect until the next time the Btrieve NLM is loaded.    
  1512.    
  1513. 4.  To load the NLM, run BSTART.   
  1514.    
  1515.     At the file server console prompt, type:   
  1516.    
  1517.     BSTART <ENTER>   
  1518.    
  1519.     BSTART is an NCF file which loads both BTRIEVE.NLM and BSPXCOM.NLM.   
  1520.    
  1521. 5.  To unload the Btrieve NLM, issue the BSTOP command.   
  1522.    
  1523.     If the Btrieve NLM was loaded when changes were made in BSETUP, you    
  1524.     need to unload Btrieve and then reload the NLMs in order for the changes    
  1525.     to take effect.   
  1526.    
  1527.     For example, at the console prompt, type:   
  1528.    
  1529.     BSTOP <ENTER>   
  1530.     BSTART <ENTER>   
  1531.    
  1532.    
  1533.    
  1534. 32.2 Using Brequest in a Login Script   
  1535.    
  1536. To ensure that EQUIP is executed on a regular basis, the EQUIP command can    
  1537. be placed in your system login script.  Because the Btrieve database must be    
  1538. loaded before running EQUIP, a Btrieve command must also be placed in the    
  1539. login script.  EQUIP executes much faster when used in conjunction with    
  1540. Brequest and the BTRIEVE NLM; therefore, the login script should contain    
  1541. the BREQUEST.EXE command.     
  1542.    
  1543. The following example illustrates how EQUIP can be run from the system login    
  1544. script, using BREQUEST.  Comments are indicated in the text between the    
  1545. angle brackets.   
  1546.    
  1547.     MAP F:=FS/SYS:Fusion <maps drive to Fusion dir>   
  1548.     DRIVE F: <changes to the Fusion dir>   
  1549.     #BREQUEST /D:17000   
  1550.     #EQUIP <specify scan parameters>   
  1551.     #ENDBTRV   
  1552.    
  1553. NOTES: a -  Loading SPX -  All BrightWorks modules require SPX to be loaded    
  1554. at each workstation. Brequest communicates with BSPXCOM.NLM via SPX.     
  1555. BSPXCOM, in turn, passes all requests from Brequest to the BTRIEVE NLM.     
  1556. If SPX is not loaded at a workstation, that workstation has no communication    
  1557. whatsoever with the Btrieve record manager. If you have loaded Brequest and    
  1558. are getting "BTRIEVE Record Manager Not Loaded" messages, make sure that    
  1559. SPX is loaded.  This normally only becomes an issue on workstations that    
  1560. load the ODI drivers because the ODI drivers can optionally load SPX.   
  1561. b -  Brequest /D switch - The /D: parameter specifies the size of the "data    
  1562. message buffer length."  This buffer refers to the maximum record size that    
  1563. the NLM will transmit to the workstation.  This switch should be set to    
  1564. 17000 for the purposes of BrightWorks.   
  1565. c -  Brequest /L switch - When running SDUPDATE.EXE in a DOS box, you must    
  1566. load another session of BREQUEST by entering the following command:    
  1567.     BREQUEST /D:17000 /L   
  1568. After running the program, end the additional session by issuing the    
  1569. ENDBTRV command.   
  1570. d -  Brequest Error 87 - If you receive an "Error 87" from Btrieve while    
  1571. using Brequest, increase the 'Number Of Open Files' setting in BSETUP.   
  1572.    
  1573.    
  1574.    
  1575. 32.3 Using the Btrieve VAP    
  1576.    
  1577. All of the options and suggestions regarding the Btrieve NLM also apply to    
  1578. the Btrieve VAP.  The BSETUP parameters, Brequest parameters, and Windows    
  1579. requester initialization settings are identical.   
  1580.    
  1581. NOTE:  When using the Btrieve VAP, the file server needs to be rebooted in    
  1582. order for any changes in BSETUP to take effect.    
  1583.    
  1584.    
  1585.    
  1586. 33.0 Btrieve Status Codes   
  1587.    
  1588. This appendix lists the return status codes for Novell's Btrieve Record    
  1589. Manager.   
  1590.    
  1591.    
  1592. 33.1 Btrieve Status Codes   
  1593.    
  1594. Btrieve returns a status code after each operation an application performs.     
  1595. If the operation was successful, Btrieve returns status code 0.  If the    
  1596. operation was not successful, Btrieve will return one of the nonzero status    
  1597. codes described in this section.   
  1598.    
  1599. If Btrieve returns a code that is not contained in this section, refer to    
  1600. your Btrieve Installation and Operation Manual for error codes from the    
  1601. utilities.   
  1602.    
  1603. 01  INVALID OPERATION   
  1604.     The operation parameter specified in the call is invalid.   
  1605.    
  1606. 02  I/O ERROR   
  1607.     An error occurred during disk read/write.  This status code    
  1608.     indicates that the file has been damaged and must be recreated, or    
  1609.     that the file specified on the open call was not created.  This    
  1610.     status code also occurs if the application passed an invalid    
  1611.     position block.   
  1612.    
  1613. 03  FILE NOT OPEN   
  1614.     The operation cannot execute because the file is not open.  A    
  1615.     successful Open operation must be performed before Btrieve can    
  1616.     process any other operations.  This status code may also occur if    
  1617.     the application passed an invalid position block for the file.   
  1618.    
  1619. 04  KEY VALUE NOT FOUND   
  1620.     The specified key value in the index path was not found.   
  1621.    
  1622. 05  DUPLICATE KEY VALUE   
  1623.     A record with a key field containing a duplicate key value cannot    
  1624.     be added to an index that does not allow duplicate values.   
  1625.    
  1626. 06  INVALID KEY NUMBER   
  1627.     The value stored in the key number parameter was not valid for the    
  1628.     file being accessed.  The key number must correspond to one of the    
  1629.     keys defined when the file was created or to a supplemental index.   
  1630.    
  1631. 07  DIFFERENT KEY NUMBER   
  1632.     The key number parameter changed before a Get Next, Get Next    
  1633.     Extended, Get Previous, Get Previous Extended, Update, or Delete    
  1634.     operation.  The operation specified requires the same key number    
  1635.     parameter as the previous operation because Btrieve uses positioning    
  1636.     information relative to the previous key number.   
  1637.    
  1638.     If you need to change key numbers between consecutive Get Next, Get    
  1639.     Next Extended, Get Previous, or Get Previous Extended operations,    
  1640.     use a Get Position operation followed by a Get Direct operation to    
  1641.     re-establish positioning for the new index path.   
  1642.    
  1643. 08  INVALID POSITIONING   
  1644.     The current position must be established to update or delete a    
  1645.     record.  Perform a Get or Step operation to establish the current    
  1646.     position.  This status code may also occur if the application    
  1647.     passed an invalid position block for the file.   
  1648.    
  1649. 09  END-OF-FILE   
  1650.     The operation tried to read past the file boundaries (end-of-file or    
  1651.     start-of-file).  When reading a file in ascending order according to    
  1652.     an index path, Btrieve returns the last record in that index path.     
  1653.     When reading a file in descending order according to an index path,    
  1654.     Btrieve returns the first record in the index path.   
  1655.    
  1656.     The Get Extended and Step Extended operations return this status    
  1657.     code if the number of records satisfying the filtering condition is    
  1658.     less than the number of specified records to be returned and the    
  1659.     reject count has not been reached.   
  1660.    
  1661. 10  MODIFIABLE KEY VALUE ERROR   
  1662.     The operation tried to modify a key field which is defined as    
  1663.     non-modifiable.   
  1664.    
  1665. 11  INVALID FILENAME   
  1666.     The filename specified does not conform to file naming conventions.   
  1667.    
  1668. 12  FILE NOT FOUND   
  1669.     The filename specified does not exist.  Check the key buffer    
  1670.     parameter to make sure the pathname is terminated with a blank or    
  1671.     a binary zero.   
  1672.    
  1673. 13  EXTENDED FILE ERROR   
  1674.     Btrieve could not find the extension file for an extended file    
  1675.     which the application tried to open.  Extension files must be    
  1676.     loaded on the logical disk drive specified when the extension was    
  1677.     created.  Both the primary file and its extension file must be    
  1678.     on-line to access an extended file.   
  1679.    
  1680. 14  PRE-IMAGE OPEN ERROR   
  1681.     The pre-image file could not be created or opened.  There are three    
  1682.     possible causes for this error.   
  1683.         - Btrieve could not create a new pre-image file because your    
  1684.         disk directory is full.  Btrieve must be able to create a    
  1685.         pre-image file.   
  1686.         - Btrieve could not open the pre-image file to restore file    
  1687.         integrity.  If the pre-image file was erased or damaged,    
  1688.         Btrieve cannot restore the file's integrity.  In this case,    
  1689.         either use the RECOVER command in the BUTIL utility to    
  1690.         retrieve the damaged file's data records in a sequential    
  1691.         file, or replace the file with its most recent backup.   
  1692.         - Btrieve could not assign a handle to the pre-image file    
  1693.         because the Btrieve was not started by a user with access    
  1694.         rights to the pre-image file.   
  1695.    
  1696. 15  PRE-IMAGE I/O ERROR   
  1697.     An I/O error occurred during the pre-imaging function.  Either the    
  1698.     disk is full or the pre-image file is damaged.   
  1699.         - If the disk is full, erase any unnecessary files or    
  1700.         extend the file to gain additional disk space.   
  1701.         - If the pre-image file is damaged, the integrity of    
  1702.         the Btrieve file cannot be ensured.  Either use the    
  1703.         RECOVER command in the BUTIL utility to retrieve the    
  1704.         damaged file's data records in a sequential file, or    
  1705.         replace the file with its most recent backup.   
  1706.    
  1707. 16  EXPANSION ERROR   
  1708.     An error occurred while writing the directory structure to disk    
  1709.     prior to the creation of the expanded file partition.  Either    
  1710.     Btrieve could not close the file, or a new page was added to the    
  1711.     file and Btrieve could not close and reopen the file to update the    
  1712.     directory structure.  Check for a disk hardware failure.   
  1713.    
  1714. 17  CLOSE ERROR   
  1715.     An error occurred while writing the directory structure to disk    
  1716.     prior to closing the file.  Either Btrieve could not close the file,    
  1717.     or a new page was added to the file and Btrieve could not close and    
  1718.     reopen the file to update the directory structure.  Check for a    
  1719.     disk hardware failure.  This status code also occurs if the    
  1720.     application passed an invalid position block for the file.   
  1721.    
  1722. 18  DISK FULL   
  1723.     The disk is full and the file could not be expanded to accommodate    
  1724.     the insertion.  Either erase any unnecessary files or extend the    
  1725.     file to gain additional disk space.   
  1726.    
  1727. 19  UNRECOVERABLE ERROR   
  1728.     An unrecoverable error has occurred.  File integrity cannot be    
  1729.     ensured.  Either use the RECOVER command in the BUTIL utility to    
  1730.     retrieve the damaged file's data records in a sequential file, or    
  1731.     replace the Btrieve with its most recent backup.   
  1732.    
  1733. 20  RECORD MANAGER INACTIVE   
  1734.     A request has been made before the Record Manager has been started.     
  1735.     Restart the Record Manager.   
  1736.        
  1737.     In network environments, the operation was not processed because    
  1738.     BREQUEST was not loaded.  Reload BREQUEST.   
  1739.    
  1740. 21  KEY BUFFER TOO SHORT   
  1741.     The key buffer parameter was not long enough to accommodate the    
  1742.     key field for the index path requested.  Verify that the length of    
  1743.     the key buffer equals the defined length of the key specified in    
  1744.     the key number parameter.  This status code can be returned only by    
  1745.     certain interfaces.   
  1746.    
  1747. 22  DATA BUFFER LENGTH   
  1748.     The data buffer parameter was not long enough to accommodate the    
  1749.     length of the data record defined when the file was created.  Verify    
  1750.     that the length of the data buffer is at least as long as the    
  1751.     file's defined record length.   
  1752.         - For Get or Step operations, if the data buffer is too    
  1753.         short to contain the fixed length portion of the record,    
  1754.         Btrieve does not return any data to the data buffer.  If    
  1755.         the record is a variable length record and the data buffer    
  1756.         is too short to contain the entire variable length portion    
  1757.         of the record, Btrieve returns as much data as it can and a    
  1758.         status code 22, indicating that it could not return the    
  1759.         entire record.   
  1760.         - For the Insert operation, Btrieve does not insert the    
  1761.         record if the data buffer is shorter than the fixed    
  1762.         length portion of the record.   
  1763.         - For the Update operation, if the data buffer is too    
  1764.         short to contain the fixed length portion of any record,    
  1765.         Btrieve does not update the record.   
  1766.         - For the Create, Stat, and Create Supplemental Index    
  1767.         operations, a status code 22 indicates that the data    
  1768.         buffer is not long enough to contain all the file and    
  1769.         key specifications, and the alternate collating sequence    
  1770.         definition, if specified.   
  1771.    
  1772. 23  POSITION BLOCK LENGTH   
  1773.     The position block parameter was not 128 bytes long.  This error    
  1774.     can only be detected using certain language interfaces.   
  1775.    
  1776. 24  PAGE SIZE ERROR   
  1777.     The page size was invalid.  The page size must be a multiple of    
  1778.     512 bytes but must be no larger than 4096 bytes. To solve this, run  
  1779.     or load BSETUP at the file server and change the page size to 4096   
  1780.     and the loargest record size to 17000. Refer to Chapter 32 for more  
  1781.     information.  
  1782.    
  1783. 25  CREATE I/O ERROR   
  1784.     The file specified could not be created.  Possible causes are a    
  1785.     full disk directory or a full disk.  If you are creating a file    
  1786.     over an existing file, Btrieve returns this status code if the    
  1787.     existing file is open or the operating system does not allow the    
  1788.     creation for some other reason (for example, a NetWare file is    
  1789.     flagged transactional).   
  1790.    
  1791. 26  NUMBER OF KEYS   
  1792.     The number of keys specified for the page size was invalid.     
  1793.     For standard Btrieve files with a page size of 512 bytes, the    
  1794.     number of key segments must be between 1 and 8.  For larger page    
  1795.     sizes, the number of key segments must be between 1 and 24.  You    
  1796.     must define at least one key without the null attribute.   
  1797.    
  1798. 27  INVALID KEY POSITION   
  1799.     The key field position specified exceeded the defined record    
  1800.     length for the file.  Either the key position was greater than the    
  1801.     record length or the key position plus the key length exceeded the    
  1802.     record length.  For key-only files, the key must begin in the first    
  1803.     byte of the record (position 1).   
  1804.    
  1805. 28  INVALID RECORD LENGTH   
  1806.     The record length was invalid.  The record length specified    
  1807.     (plus overhead for duplicates) must be less than or equal to the    
  1808.     page size minus 6 or greater than or equal to 4 bytes long.   
  1809.    
  1810. 29  INVALID KEY LENGTH   
  1811.     The key length was invalid.  The key length specified must be    
  1812.     greater than zero and cannot exceed 255.  The length of a binary    
  1813.     key must be even.  Btrieve requires that each key page in the    
  1814.     file is large enough to hold at least eight keys.   
  1815.    
  1816.     If the page size is too small to accommodate eight occurrences of    
  1817.     the specified key length (plus overhead), either increase the    
  1818.     file's page size, or decrease the key length.   
  1819.    
  1820. 30  NOT A BTRIEVE FILE   
  1821.     The filename specified is not a valid Btrieve file. Either the    
  1822.     file was not created by Btrieve, or it was created by an earlier    
  1823.     version of Btrieve.   
  1824.    
  1825.     Another possibility is that the first page of the file, which    
  1826.     contains the File Control Record, is damaged.   
  1827.    
  1828. 31  FILE ALREADY EXTENDED   
  1829.     The file specified has already been extended.  A file can be    
  1830.     extended only once.   
  1831.    
  1832. 32  EXTEND I/O ERROR   
  1833.     The file could not be extended.  Possible causes are that the    
  1834.     directory is full, the disk is full, or the disk is write protected.   
  1835.    
  1836. 34  INVALID EXTENSION NAME   
  1837.     The filename specified for the extended partition was invalid.   
  1838.    
  1839. 35  DIRECTORY ERROR   
  1840.     An error occurred while changing to the directory that contains    
  1841.     the Btrieve file.  Either the drive specified in the Get Directory    
  1842.     operation does not exist or the pathname specified in a Set    
  1843.     Directory operation was invalid.   
  1844.    
  1845. 36  TRANSACTION ERROR   
  1846.     A Begin Transaction operation could not be performed because no    
  1847.     transactions were specified when the Btrieve was initialized.   
  1848.    
  1849. 37  TRANSACTION IS ACTIVE   
  1850.     A Begin Transaction was issued while another transaction was active    
  1851.     at that station.  Transactions cannot be nested.   
  1852.    
  1853. 38  TRANSACTION CONTROL FILE I/O ERROR   
  1854.     An error occurred when Btrieve tried to write to the transaction    
  1855.     control file.  Possible causes were that the disk was full, the    
  1856.     disk was write protected, or the transaction control file (which    
  1857.     was created when the Btrieve was loaded) was deleted.   
  1858.    
  1859. 39  END/ABORT TRANSACTION ERROR   
  1860.     An End or Abort Transaction operation was issued without a    
  1861.     corresponding Begin Transaction operation.   
  1862.    
  1863. 40  TRANSACTION MAX FILES   
  1864.     The application tried to update more than the maximum number of    
  1865.     files allowed within a transaction.  The maximum number of    
  1866.     different files that can be updated during a logical transaction    
  1867.     is set when Btrieve is configured.  Refer to your Btrieve    
  1868.     Installation and Operation manual for more information on    
  1869.     configuration.   
  1870.    
  1871. 41  OPERATION NOT ALLOWED   
  1872.     The application tried to perform an operation that is not allowed    
  1873.     at this time.  Some operations are not allowed under certain    
  1874.     operating conditions.  For example, Btrieve returns this status    
  1875.     code if you attempt to perform a Step, Update, or Delete operation    
  1876.     on a key-only file or a Get operation on a data only file.   
  1877.    
  1878.     lso, certain operations are prohibited during transactions because    
  1879.     they have too great an effect on the pre-image file or on Btrieve's    
  1880.     performance.  These operations include Close, Set or Clear Owner,    
  1881.     Extend, Create Supplemental Index, and Drop Supplemental Index.   
  1882.    
  1883. 42  INCOMPLETE ACCELERATED ACCESS   
  1884.     The application tried to open a file that was previously accessed    
  1885.     in accelerated mode and never successfully closed.  The file's    
  1886.     integrity cannot be ensured.  Either use the RECOVER command in    
  1887.     the BUTIL utility to build a new file or restore the file using    
  1888.     the latest backup.   
  1889.    
  1890. 43  INVALID RECORD ADDRESS   
  1891.     The record address specified for a Get Direct operation was invalid.     
  1892.     The address is outside of the file's boundaries; it is not on a    
  1893.     record boundary within a data page, or on a data page.  The 4-byte    
  1894.     address you specify for a Get Direct operation should be one that    
  1895.     was obtained by a Get Position operation.   
  1896.    
  1897. 44  NULL KEY PATH   
  1898.     The application tried to use the Get Direct operation to establish    
  1899.     an index path for a key whose value is null in the corresponding    
  1900.     record.  Btrieve cannot establish positioning based on a null key    
  1901.     value.   
  1902.    
  1903. 45  INCONSISTENT KEY FLAGS   
  1904.     The key flags specification on a Create operation was inconsistent.     
  1905.     If a key has multiple segments, the duplicate, modifiable, and    
  1906.     null attributes should be the same for each segment in the key.   
  1907.    
  1908. 46  ACCESS TO FILE DENIED   
  1909.     The application opened a file in read-only mode and tried to    
  1910.     perform an Update, Delete, or Insert on that file.  Another    
  1911.     possible cause is that the owner name required for updates was    
  1912.     not specified correctly when you opened the file.   
  1913.    
  1914. 47  MAXIMUM OPEN FILES   
  1915.     The number of files opened in accelerated mode exceeded the number    
  1916.     of buffers available in Btrieve's cache.  When a file is opened in    
  1917.     accelerated mode, Btrieve reserves one of its cache buffers for the    
  1918.     file.  Btrieve always reserves five empty buffers for index    
  1919.     manipulation.  Reconfigure the Btrieve Record Manager with a    
  1920.     smaller page size parameter to allocate more buffers.   
  1921.    
  1922. 48  INVALID ALTERNATE SEQUENCE DEFINITION   
  1923.     The first byte of an alternate collating sequence definition    
  1924.     (the identification byte) did not contain the hexadecimal value AC.   
  1925.    
  1926. 49  KEY TYPE ERROR   
  1927.     The application tried to create a file or a supplemental index    
  1928.     with an invalid extended key type, or tried to assign an alternate    
  1929.     collating sequence to a binary key or key segment.  You can only    
  1930.     assign an alternate collating sequence to a string, lstring, or    
  1931.     zstring key type.   
  1932.    
  1933.     This status code is also returned if you define a supplemental    
  1934.     index requiring an alternate collating sequence, and no alternate    
  1935.     collating sequence definition exists either in the file or in the    
  1936.     key definition passed in the data buffer.   
  1937.    
  1938. 50  OWNER ALREADY SET   
  1939.     The application tried to perform a Set Owner operation on a file    
  1940.     that already has an owner.  Use the Clear Owner operation to    
  1941.     remove the previous owner before specifying a new one.   
  1942.    
  1943. 51  INVALID OWNER   
  1944.     There are two possible causes for this status code:   
  1945.         - If your application received this status code after    
  1946.         a Set Owner operation, the owner names specified in    
  1947.         the key buffer and data buffer did not match.   
  1948.         - If your application received this status code after    
  1949.         an Open operation, the file you tried to open has an    
  1950.         owner name assigned to it.  Your application must    
  1951.         specify the correct owner name in the data buffer.   
  1952.            
  1953. 52  ERROR WRITING CACHE   
  1954.     While trying to make a cache buffer available, Btrieve tried to    
  1955.     write data to a logical disk drive from a file that was previously    
  1956.     opened in accelerated mode.  An I/O error occurred during a write.   
  1957.    
  1958. 53  INVALID INTERFACE   
  1959.     An application tried to access a file containing variable length    
  1960.     records with a language interface from Btrieve v3.15 or earlier.     
  1961.     To access files with variable length records, you must use v4.xx or    
  1962.     later interface.   
  1963.    
  1964. 54  VARIABLE PAGE ERROR   
  1965.     During a Step Direct operation, Btrieve could not read all or part    
  1966.     of the variable length portion of a record.  In this case, Btrieve    
  1967.     returns as much data as possible to your application.  This error    
  1968.     usually indicates file damage to one or more pages in the file.   
  1969.    
  1970. 55  AUTOINCREMENT ERROR   
  1971.     The application tried to specify either the segmented or duplicate    
  1972.     attribute for an autoincrement key type.  An autoincrement key    
  1973.     cannot be part of another key and cannot allow duplicates.   
  1974.    
  1975. 56  INCOMPLETE INDEX   
  1976.     A supplemental index was damaged.  This can occur if a Create    
  1977.     Supplemental Index operation or a Drop Supplemental Index    
  1978.     operation is interrupted and does not run to completion.  Perform    
  1979.     a Drop Supplemental Index operation to completely remove the index    
  1980.     from the file.   
  1981.    
  1982. 57  EXPANDED MEMORY ERROR   
  1983.     This error is applicable only in the client-based DOS environment.     
  1984.     Btrieve returns this status if it receives an error from the    
  1985.     Expanded Memory Manager.  This error usually means that Btrieve    
  1986.     was unable to save or restore the memory mapping register context,    
  1987.     indicating an incompatibility with another application that uses    
  1988.     expanded memory.   
  1989.    
  1990. 58  COMPRESSION BUFFER TOO SHORT   
  1991.     The application tried to read or write a record that is longer    
  1992.     than the value specified for the size of the compression buffer.     
  1993.     Reconfigure the Btrieve Record Manager, specifying a higher value    
  1994.     for the "Maximum Compressed Record Size" option.   
  1995.    
  1996. 59  FILE ALREADY EXISTS   
  1997.     This status code is returned for the Create operation if you    
  1998.     specified -1 in the key number parameter and the name of an    
  1999.     existing file in the key buffer parameter.   
  2000.    
  2001. 60  REJECT COUNT REACHED   
  2002.     Btrieve rejected the number of records specified by the reject    
  2003.     count before an Extended Get/Step operation found the requested    
  2004.     number of records which satisfy the filtering condition.  Check    
  2005.     the first two bytes of the data buffer returned for the number of    
  2006.     records that were retrieved.   
  2007.    
  2008. 61  WORK SPACE TOO SMALL   
  2009.     The Extended Get/Step operations use the pre-image buffer as    
  2010.     work space.  This error code indicates that the work space was    
  2011.     not large enough to hold the filtering data buffer structure and    
  2012.     the largest record to be received.  The size of the work space is    
  2013.     configurable (see the Btrieve Installation and Operation manual for    
  2014.     more information).  Check the first two bytes of the data buffer    
  2015.     returned for the number of records that were retrieved.   
  2016.    
  2017. 62  INCORRECT DESCRIPTOR   
  2018.     The descriptor (data buffer structure), which is passed for an    
  2019.     extended Get or Step operation, is incorrect.   
  2020.    
  2021. 63  INVALID EXTENDED INSERT BUFFER   
  2022.     Extended Insert provides an invalid buffer.  Either the buffer    
  2023.     length is less than five bytes, or the number of records specified    
  2024.     is zero.   
  2025.    
  2026. 64  FILTER LIMIT REACHED   
  2027.     During an Extended Get Next/Previous operation, a rejected record    
  2028.     was reached.  Furthermore, this rejected record is such that no    
  2029.     other record can satisfy the given filtering condition, going in    
  2030.     the direction specified by the operation.  This is applicable only    
  2031.     if the key specified by the key number is also used as the filtering    
  2032.     field.   
  2033.    
  2034. 65  INCORRECT FIELD OFFSET   
  2035.     The field offset in the extractor of an Extended Get/Step is invalid    
  2036.     based on the length of the retrieved record.   
  2037.    
  2038. 74  AUTOMATIC TRANSACTION ABORT   
  2039.     This is an informative status code and is applicable only in the    
  2040.     server-based environment.  Btrieve replaced an End Transaction    
  2041.     operation with an Abort Transaction because an error had been    
  2042.     detected for a TTS file inside the transaction.  In addition,    
  2043.     Btrieve executed the Abort Transaction operation.   
  2044.    
  2045. 78  DEADLOCK DETECTED   
  2046.     Btrieve detected a deadlock condition.  The application should    
  2047.     clear all resources (such as aborting or ending the transaction or    
  2048.     releasing all record locks) before proceeding.  This allows the other    
  2049.     applications to access the resources for which they are waiting.   
  2050.    
  2051. 80  CONFLICT   
  2052.     The Update or Delete operation could not be performed because the    
  2053.     record was changed by another application since your application    
  2054.     read the record.  Reread the record prior to resending an Update or    
  2055.     Delete operation.   
  2056.    
  2057. 81  LOCK ERROR   
  2058.     This error can result from one of two conditions:   
  2059.         -  The Btrieve lock table was full.  Decrease the number    
  2060.         of locks that your application uses or reconfigure the    
  2061.         Btrieve Record Manager and specify a higher value for the    
  2062.         "Maximum Number of Record Locks" option.   
  2063.         -  The application tried to unlock one record that was    
  2064.         locked with a multiple record lock, and the record position    
  2065.         stored in the data buffer did not correspond with any    
  2066.         record that was locked in that file.   
  2067.    
  2068. 82  LOST POSITION   
  2069.     When performing a Get Next or Get Previous on a key with duplicates,    
  2070.     the application tried to retrieve a record that was deleted or    
  2071.     whose key value was modified by another application.  Re-establish    
  2072.     positioning using a Get Equal or a Get Direct operation.   
  2073.    
  2074. 83  READ OUTSIDE TRANSACTION   
  2075.     The application tried to delete or update a record within a    
  2076.     transaction, but the record was not read within the transaction.     
  2077.     If you are going to update or delete a record within a transaction,    
  2078.     you must read the record within the transaction to ensure you have    
  2079.     first obtained exclusive access to the data.   
  2080.    
  2081. 84  RECORD LOCKED   
  2082.     The application tried to apply a nowait lock on a record that was    
  2083.     currently locked by another application, or to apply a nowait lock    
  2084.     on a file while another application held active record lock(s) in    
  2085.     that file.   
  2086.    
  2087.     If this status code is returned, your application can use either    
  2088.     of the following two methods:   
  2089.         - Retry the operation until it is successful.  Under light    
  2090.         to moderate network use, this may be the simplest and    
  2091.         quickest solution.   
  2092.         - Use the wait option (+100/+300) instead of the nowait    
  2093.         option.   
  2094.    
  2095. 85  FILE LOCKED   
  2096.     The application tried to apply a nowait record or file lock while    
  2097.     another application held the file locked.  This status code is    
  2098.     also returned when the application tries to open a file outside of    
  2099.     a transaction and the file is locked by some other application.   
  2100.    
  2101.     If this status code is returned, your application can use either    
  2102.     of the following two methods:   
  2103.         - Retry the operation until it is successful.  Under    
  2104.         light to moderate network use, this may be the simplest    
  2105.         and quickest solution.   
  2106.         - Use the wait option (+100/+300) instead of the nowait    
  2107.         option.   
  2108.    
  2109. 86  FILE TABLE FULL   
  2110.     Btrieve's file table was full.  Reconfigure Btrieve and specify a    
  2111.     higher value for the "Maximum Number of Open Files" option.   
  2112.    
  2113. 87  HANDLE TABLE FULL   
  2114.     This status code is applicable only in the server-based and Windows    
  2115.     environments.   
  2116.     Btrieve's handle table was full.  Reconfigure the Btrieve and    
  2117.     specify a higher value for the "Maximum Number of File Handles"    
  2118.     option.   
  2119.    
  2120. 88  INCOMPATIBLE MODE ERROR   
  2121.     The application tried to open a file in an incompatible mode.  If    
  2122.     the first application to access a file opens it in accelerated mode,    
  2123.     all other applications must open it in accelerated mode.  If the    
  2124.     first application to access a file opens it in non-accelerated mode,    
  2125.     other applications cannot open the file in accelerated mode.   
  2126.    
  2127. 90  REDIRECTED DEVICE TABLE FULL   
  2128.     This status code is applicable only in the server-based environment.    
  2129.     BREQUEST's redirection table or server routing table was full.     
  2130.     This occurs if you attach to additional servers or map to additional    
  2131.     drives after you loaded BREQUEST.  Reload BREQUEST, specifying a    
  2132.     larger number for the "Number of File Servers" or "Number of    
  2133.     Mapped Drives" options (/S and /R respectively).   
  2134.    
  2135.     This error also occurs if you detach a particular server and attach    
  2136.     to a different server.  Once a workstation has attached to a server,    
  2137.     BREQUEST will not remove its name from the server routing table.   
  2138.    
  2139. 91  SERVER ERROR   
  2140.     This status code is applicable only in the server-based environment.   
  2141.     BREQUEST could not establish a session with the server.  In NetWare    
  2142.     environments, either the NetWare Btrieve Record Manager has not    
  2143.     been started or the server was not active.  Verify that the    
  2144.     NetWare Btrieve Record Manager is active on the server in question.   
  2145.    
  2146. 92  TRANSACTION TABLE FULL   
  2147.     This status code is applicable only in the server-based environment.   
  2148.     The maximum number of active transactions was exceeded.  Reconfigure    
  2149.     Btrieve and specify a higher value for the "Number of Concurrent    
  2150.     Transactions" option.   
  2151.    
  2152. 93  INCOMPATIBLE LOCK TYPE   
  2153.     Your application tried to mix single record locks (+100/+200) and    
  2154.     multiple record locks (+300/+400) in the same file at the same time.    
  2155.     All locks of one type must be released before a lock of the other    
  2156.     type can be executed.   
  2157.    
  2158. 94  PERMISSION ERROR   
  2159.     Your application tried to open or create a file in a directory    
  2160.     without the proper privileges.  Btrieve does not override the    
  2161.     network privileges assigned to users.   
  2162.    
  2163. 95  SESSION NO LONGER VALID   
  2164.     This status code is applicable only in the server-based environment.   
  2165.     The previously established session was no longer active due to an    
  2166.     error at the workstation, the file server, or on the network.     
  2167.     Verify that your workstation is still attached to the file server    
  2168.     and then reload BREQUEST.   
  2169.    
  2170. 96  COMMUNICATIONS ENVIRONMENT ERROR   
  2171.     This status code is applicable only in the server-based environment.   
  2172.     This code occurs when loading Btrieve on a NetWare server.  The SPX    
  2173.     connection table is full.  Reload SPX, specifying a higher value    
  2174.     for the connection table.  Refer to the NetWare system documentation    
  2175.     for more information.   
  2176.    
  2177. 97  DATA MESSAGE TOO SMALL   
  2178.     This status code is applicable only in the server-based environment.   
  2179.     Your application tried to read or write a record which was longer    
  2180.     than the Btrieve Record Manager or BREQUEST could handle.     
  2181.     Reconfigure the Btrieve Record Manager and specify a higher value    
  2182.     for the "Maximum Record Length" option.  Reload BREQUEST and    
  2183.     specify a higher value for the /D option.   
  2184.    
  2185.         - For an Update, Insert, or Create operation, the application    
  2186.         receives this error if the data buffer length it specifies    
  2187.         for the record exceeds the length specified for the Btrieve    
  2188.         Record Manager or BSERVER.   
  2189.         - For a Get, Step, or Stat operation, the application    
  2190.         receives this error if the value specified for the data    
  2191.         buffer length is shorter than the length of the data Btrieve    
  2192.         would return, regardless of the data buffer length specified    
  2193.         in the program.   
  2194.    
  2195. 98  INTERNAL TRANSACTION ERROR   
  2196.     This status code is applicable only in the server-based environment.   
  2197.     An error has been detected while executing a previous operation on    
  2198.     a NetWare TTS file.  Therefore, no operation other than Abort    
  2199.     Transaction (21) is allowed at this point.   
  2200.    
  2201. 99  THE REQUESTER CANNOT ACCESS THE NETWARE RUNTIME SERVER   
  2202.     The DOS Requester returns this status code when NetWare Runtime    
  2203.     server support is enabled (/C:1) and the Requester either detects    
  2204.     no existing connection or cannot find a valid login username.     
  2205.     If the Requester cannot find a login username other than    
  2206.     SUPERVISOR, there is no valid name to pass.   
  2207.    
  2208. 100  NO CACHE BUFFERS ARE AVAILABLE   
  2209.     Btrieve has used all the cache buffers it allocated at load time.     
  2210.     Using the Setup utility, you can increase the value for the Cache    
  2211.     Allocation configuration option.  Alternatively, you can change the    
  2212.     Number of Remote Sessions configuration option to decrease the    
  2213.     number of concurrent Btrieve users.  For more information, refer    
  2214.     to Chapter 3, "Installing and Configuring Btrieve," in the    
  2215.     Btrieve Installation and Operation manual.   
  2216.    
  2217. 101  INSUFFICIENT OPERATING SYSTEM MEMORY IS AVAILABLE   
  2218.     There is not enough operating system memory available to perform    
  2219.     the requested operation.  Decrease the value for the Cache    
  2220.     Allocation configuration option (using the Setup utility),    
  2221.     decrease the number of concurrent Btrieve users (using the Number    
  2222.     of Remote Sessions configuration option in the Setup utility), or    
  2223.     add memory to the server.  For more information on the configuration    
  2224.     options, refer to Chapter 3, "Installing and Configuring Btrieve,"    
  2225.     in the Btrieve Installation and Operation manual.   
  2226.    
  2227. 102  INSUFFICIENT STACK SPACE IS AVAILABLE   
  2228.     Btrieve has run out of stack space.  To increase the amount of    
  2229.     stack space available to your application, relink the application,    
  2230.     setting the stack size to a higher value.  Only the NLM    
  2231.     applications calling Btrieve on the local server get this message.   
  2232.    
  2233. 103  THE CHUNK OFFSET IS TOO BIG   
  2234.     A Get Direct/Chunk operation has specified an offset beyond the    
  2235.     end of the record, either explicitly or through the use of the    
  2236.     next-in-record bias to the subfunction value.  Unless Btrieve    
  2237.     returns this status while processing the first chunk, the    
  2238.     operation was partially successful.  Check the data buffer length    
  2239.     parameter immediately after the call to see how much data    
  2240.     (and therefore how many chunks) Btrieve retrieved.   
  2241.    
  2242.     This code can also be returned by the Update Chunk operation    
  2243.     when the specified offset is more than one byte beyond the end of    
  2244.     the record.  However, in this situation, Status Code 103    
  2245.     indicates that Btrieve made no changes to the record.   
  2246.    
  2247. 104  THE LOCALE INFORMATION COULD NOT BE FOUND   
  2248.     The Create or Create Index function returns this status code to    
  2249.     indicate that the operating system was not able to return a    
  2250.     collation table for the country ID and code page specified.     
  2251.     Check that the application specified the locale's country ID and    
  2252.     code page correctly and that the operating system is configured to    
  2253.     support the country ID and code page.   
  2254.    
  2255. 105  THE FILE CANNOT BE CREATED WITH VARIABLE-TAIL ALLOCATION TABLES (VATS)   
  2256.     The application specified that a Btrieve file should be created    
  2257.     with Variable-tail Allocation Tables (VATs); however, the    
  2258.     application failed to specify that the file was to use    
  2259.     variable-length records (a precondition for files to use VATs).     
  2260.     This status applies to key-only files as well as regular data files.   
  2261.    
  2262. 106  THE OPERATION CANNOT GET THE NEXT CHUNK   
  2263.     The application called the Get Direct/Chunk operation to retrieve    
  2264.     a chunk from a record and used the next-in-record bias on the    
  2265.     descriptor subfunction.  However, after the application    
  2266.     established its positioning in the record (but prior to this call),    
  2267.     the target record was deleted.   
  2268.    
  2269. 107  CHUNK UPDATES/RETRIEVALS CANNOT BE PERFORMED ON THE FILE   
  2270.     The application tried to use either a Get Direct/Chunk operation    
  2271.     or an Update Chunk operation on a pre-v6.0 formatted file.   
  2272.    
  2273.    
  2274.    
  2275. 33.2 Client-Based Btrieve for OS/2 and Windows Status Codes   
  2276.    
  2277. Client-based Btrieve may return the following status codes in an OS/2 or    
  2278. Windows environment.   
  2279.    
  2280. 1001  THE MULTIPLE LOCKS OPTION IS OUT OF RANGE   
  2281.     The number specified for the Multiple Locks configuration option    
  2282.     must be between 1 and 255, inclusive.   
  2283.    
  2284. 1002  BTRIEVE CANNOT ALLOCATE THE MEMORY NEEDED   
  2285.     Make sure that the workstation has enough memory to load all the    
  2286.     programs it requires.   
  2287.    
  2288. 1003  THE MEMORY SIZE IS TOO SMALL   
  2289.     Make sure the value for the Memory Size configuration option is    
  2290.     large enough to accommodate the required cache size.   
  2291.    
  2292. 1004  THE PAGE SIZE OPTION IS OUT OF RANGE   
  2293.     The value of the Page Size configuration option must be an even    
  2294.     multiple of 512, and it must be between 512 and 4,096, inclusive.   
  2295.    
  2296. 1005  THE PRE-IMAGE FILE DRIVE OPTION IS INVALID   
  2297.     You must specify a valid drive letter for the Pre-Image File Drive    
  2298.     configuration option.   
  2299.    
  2300.     Note: Pre-image files are used only for files created by Btrieve    
  2301.     versions earlier than v6.x, or by v6.x if it was loaded with the    
  2302.     Create Btrieve Files in Pre v6.x Format configuration option set to    
  2303.     Yes.   
  2304.    
  2305. 1006  THE PRE-IMAGE BUFFER SIZE OPTION IS OUT OF RANGE   
  2306.     The Pre-Image Buffer Size configuration option must be between    
  2307.     1 and 64, inclusive.   
  2308.    
  2309.     Note: Pre-image files are used only for files created by Btrieve    
  2310.     versions earlier than v6.x, or by v6.x if it was loaded with the    
  2311.     Create Btrieve Files in Pre v6.x Format configuration option set    
  2312.     to Yes.   
  2313.    
  2314. 1007  THE OPEN FILES OPTION IS OUT OF RANGE   
  2315.     The Open Files configuration option must be between 1 and 255,    
  2316.     inclusive.   
  2317.    
  2318. 1008  THE CONFIGURATION OPTIONS ARE INVALID   
  2319.     The configuration options specified contain invalid or    
  2320.     unidentifiable values.  For more information on configuration    
  2321.     options, refer to the installation and operation manual for    
  2322.     your operating environment.   
  2323.    
  2324. 1009  THE TRANSACTION FILENAME OPTION IS INVALID   
  2325.     The filename specified for the Transaction Filename configuration    
  2326.     option is not valid.  Check to make sure that the transaction    
  2327.     filename is correct.   
  2328.    
  2329. 1011  THE COMPRESSION BUFFER SIZE SPECIFIED IS OUT OF RANGE   
  2330.     The Compression Buffer Size configuration option must be between    
  2331.     1 and 64, inclusive.   
  2332.    
  2333. 1013  THE TASK TABLE IS FULL (WINDOWS ONLY)   
  2334.     The Btrieve DLL may return this status code if the task entry    
  2335.     table is full.  You can remedy this situation by increasing the    
  2336.     number of available task entries; use the tasks initialization    
  2337.     option (tasks=xxx) under the [BTRIEVE] or [BREQUESTDPMI] headings    
  2338.     in NOVDB.INI.  The minimum value for this option is 1; the maximum    
  2339.     value is 255.   
  2340.    
  2341. 1014  THE APPLICATION ENCOUNTERED A STOP WARNING   
  2342.     WBTRVSTOP () returns this status code if the application still has    
  2343.     open files or an active transaction.  The application must close    
  2344.     all files and end all transactions before calling WBTRVSTOP ().   
  2345.    
  2346. 1015  A POINTER PARAMETER IS INVALID   
  2347.     One of the pointer parameters passed into Btrieve is invalid.   
  2348.    
  2349. 1016  BTRIEVE IS ALREADY INITIALIZED   
  2350.     The Btrieve DLL may return this status code if an attempt is made    
  2351.     to initialize Btrieve when it is already initialized.  To    
  2352.     reinitialize Btrieve, close all files, end/abort all transactions,    
  2353.     and call WBTRVSTOP () before calling the initialization function.   
  2354.    
  2355. 1017  THE BTRIEVE REQUESTER FOR WINDOWS CANNOT FIND WBTRVRES.DLL   
  2356.     WBTRCALL.DLL returns this status code when it cannot find the    
  2357.     resource file WBTRVRES.DLL.  You can remedy this situation by    
  2358.     placing a copy of the WBTRVRES.DLL file in the same directory as    
  2359.     the WBTRCALL.DLL file.   
  2360.    
  2361.    
  2362.    
  2363. 33.3 Btrieve Requester Status Codes   
  2364.    
  2365. This section lists the status codes that the Btrieve Requesters may generate.   
  2366.    
  2367. 2001  THE MEMORY ALLOCATION IS INSUFFICIENT   
  2368.     In an OS/2 environment, the Requester cannot allocate enough    
  2369.     memory for the parameters specified with the BRQPARMS environment    
  2370.     variable.  In a DOS environment, reduce the value specified for    
  2371.     the /D configuration option.   
  2372.    
  2373. 2002  THE OPTION IS INVALID OR OUT OF RANGE   
  2374.     In an OS/2 environment, either one of the options specified with    
  2375.     the BRQPARMS environment variable is invalid (such as /P instead    
  2376.     of /D) or the value specified for a parameter is out of range.     
  2377.     Check the SET BRQPARMS statements to make sure it is correct.   
  2378.    
  2379. 2003  THE REQUESTER DOES NOT ALLOW LOCAL ACCESS TO THE SPECIFIED FILE   
  2380.     The application attempted to access a file stored on a local drive.     
  2381.     The version of WBTRCALL.DLL installed at the workstation does not    
  2382.     allow access to local files.   
  2383.    
  2384. 2004  SPX IS NOT INSTALLED   
  2385.     Install the NetWare SPX v1.3 or later communications software for    
  2386.     OS/2.   
  2387.    
  2388. 2005  AN INCORRECT VERSION OF SPX IS INSTALLED   
  2389.     Install the NetWare SPX v1.3 or later communications software for    
  2390.     OS/2.   
  2391.    
  2392. 2006  THERE IS NO AVAILABLE SPX CONNECTION   
  2393.     SPX has already established the maximum number of sessions it can    
  2394.     handle.  To increase the maximum, edit the NET.CFG file.  Refer to    
  2395.     your NetWare documentation for more information on NET.CFG.   
  2396.    
  2397. 2007  A POINTER PARAMETER IS INVALID   
  2398.     One of the pointer parameters passed to Btrieve is invalid.  Check    
  2399.     the program to ensure that the pointer parameters are correct.   
  2400.    
  2401.    
  2402.    
  2403. 34.0 NMS Smart-Launch Support   
  2404.    
  2405. This appendix provides instructions for enabling BrightWorks smart-launch    
  2406. within NMS.   
  2407.    
  2408.    
  2409. 34.1 Enabling BrightWorks Smart-Launch within NMS   
  2410.    
  2411. Many McAfee customers have expressed an interest in utilizing the McAfee    
  2412. network management applications as snap-in applications within the Novell    
  2413. NetWare Management System framework.  In response to this request, McAfee    
  2414. has implemented support for NMS smart-launch with four of its    
  2415. currently shipping applications: BrightWorks, LAN nventory, SiteMeter    
  2416. and NETremote+.     
  2417.    
  2418. After following the instructions below, the user will be able to point at    
  2419. an object on an NMS map, select a McAfee command from the NMS Tools menu,    
  2420. and launch the selected McAfee application in a context-sensitive fashion.     
  2421.    
  2422.    
  2423. 34.1.1 Activating the Smart-Launch Feature   
  2424.    
  2425. Use the following procedure to activate the smart-launch feature.   
  2426.    
  2427. 1.  Obtain the McAfee NMS Explorer disk.   
  2428.    
  2429.     Contact your McAfee representative to obtain a copy of the "McAfee    
  2430.     NMS Explorer" Disk.  It is available free of charge.   
  2431.    
  2432. 2.  Copy all files from the NMS Explorer disk.   
  2433.    
  2434.     Two sets of files must be copied from this disk for later use, plus    
  2435.     one other file must be created.   
  2436.    
  2437.     a. Copy all of the program files (EXE, DLL) to a new directory    
  2438.     (e.g., NMS\BDI2NMS) on your NMS console (not into the NMS    
  2439.     directories!).     
  2440.    
  2441.     NOTE:  It is important to NOT copy these files into the NMS\BIN    
  2442.     directory as some of the Novell DLLs that are shipped on this disk    
  2443.     may not be the latest DLLs available from Novell for NMS.   
  2444.    
  2445.     b. Copy the FUSION.OLF file from this disk into the NMS\OLF    
  2446.     directory.  The McAfee disk includes all .OLF files that are    
  2447.     necessary for the smart-launch ready McAfee applications.  The    
  2448.     .OLF file prefixes match the McAfee product EXE names    
  2449.     (e.g., for SiteMeter the relevant files are SITEMETR.EXE and,    
  2450.     therefore, SITEMETR.OLF).   
  2451.    
  2452.     c. Copy any icon in the NMS\ICONS directory to NULL.ICO.  When    
  2453.     the Novell OLF Introducer (see below) is run it will require a    
  2454.     named icon (.ICO file) for each class introduction in case the    
  2455.     icon were to show up on an NMS map.  Since McAfee does not force    
  2456.     one of its icons onto the map, no icons are shipped on this    
  2457.     floppy.  Any of the icons in that directory may be used as the    
  2458.     source icon.   
  2459.    
  2460. 3.  Introduce NMS to McAfee.   
  2461.    
  2462.     Note that the Novell N-OLFI.EXE file must be in the NMS\BIN directory.   
  2463.    
  2464.     a. Use Novell's OLF Introducer to add the McAfee classes to the    
  2465.     NMS database.  The Introducer takes .OLF files as input.  As    
  2466.     mentioned above, .OLF files for all smart-launch ready McAfee    
  2467.     applications can be found on this disk.  It is necessary only to    
  2468.     introduce those applications that are installed to NMS.  Choose the    
  2469.     classes that you need for the McAfee applications that are desired.   
  2470.    
  2471.     b. Run the OLF Introducer (N-OLFI.EXE).  This latter program has    
  2472.     no menu; by default it displays a standard Windows common dialog    
  2473.     for opening a file.  Browse to find the target McAfee .OLF file    
  2474.     (e.g., FUSION.OLF, WLAI.OLF, SITEMETR.OLF, WNR.OLF), as appropriate.   
  2475.    
  2476.     c. Run the Introducer once for each .OLF file, specifically for    
  2477.     FUSION.OLF.   
  2478.    
  2479.     HINT:  By default the Introducer has no main window; therefore,    
  2480.     any success/failure indications cannot be seen.  Invoke N-OLFI.EXE    
  2481.     with a -s switch (for "show") to see status messages regarding    
  2482.     class introductions.  The syntax is as follows:   
  2483.    
  2484.         syntax: N-OLFI.EXE -s   
  2485.    
  2486. 4.  Explore the NMS databases for nodes and servers.   
  2487.    
  2488.     Run the McAfee BDI2NMS.EXE program included on this disk.  This program    
  2489.     requires no "setup," but it should be copied (as mentioned above) to    
  2490.     its own directory.  It requires several DLLs that are included on this    
  2491.     diskette.  These include the NWNETAPI.DLL and several of the N-*.DLLs    
  2492.     from the NMS BIN directory.   
  2493.    
  2494.     When you run BDI2NMS.EXE, you may either run the "Enable All" command    
  2495.     or select a specific McAfee product, such as BrightWorks. BDI2NMS.EXE    
  2496.     uses the NMS database APIs to search the NMS data for workstations and    
  2497.     servers.  Smart-launch is enabled for each McAfee product in the    
  2498.     following manner:   
  2499.    
  2500.     o  SiteMeter - smart-launch is enabled for servers only    
  2501.     o  BrightWorks & LAI - smart-launch is enabled for all workstations    
  2502.     and servers   
  2503.     o  NETremote+ - smart-launch is enabled for workstations only   
  2504.    
  2505. NOTE:  McAfee COULD have implemented BDI2NMS.EXE so that it would    
  2506. cross-check the existence of inventory data or an installed SiteMeter NLM    
  2507. set before enabling the smart-launch on an individual basis.  However, doing    
  2508. so would have made the software slower and would have also required the    
  2509. user to perform the NMS database query far more often than is necessary for    
  2510. normal use.   
  2511.    
  2512. To remove these settings within the NMS database, use the Disable All    
  2513. command to erase them.   
  2514.    
  2515. This software has been tested against NMS 1.15 and 2.0.  If the NMS    
  2516. database is large, the enabling exploration may take a while*this is due    
  2517. strictly to the speed of the NMS database callback API.   
  2518.    
  2519. 5.  Smart-launch BrightWorks or the BrightWorks module.   
  2520.    
  2521.     o  BrightWorks - Select the target PC or server where either EQUIP    
  2522.     or an audit have been run, and then select the Fusion command in    
  2523.     the NMS Tools menu.  BrightWorks will skip a few steps and invoke    
  2524.     the inventory details dialog box for the target node.  The network    
  2525.     number and NIC address are used as the synchronization key between    
  2526.     BrightWorks and NMS.   
  2527.    
  2528.     o  LAI - same as BrightWorks.   
  2529.        
  2530.     o  SiteMeter - Select the server within an NMS map where SiteMeter    
  2531.     is installed, and then select the SiteMeter command in the NMS    
  2532.     Tools menu.  The SiteMeter administration program is launched with    
  2533.     an Application Usage Monitor showing information on application    
  2534.     usage on that server.   
  2535.    
  2536.     o  NetRemote - Select the target workstation, and then choose    
  2537.     the NetRemote command in the NMS Tools menu.  NetRemote will be    
  2538.     invoked with the NetRemote options that are configured for the    
  2539.     target PC.  If the target PC is configured for remote control and    
  2540.     has "listen" enabled, then NetRemote+ will automatically take    
  2541.     control of the target PC.   
  2542.    
  2543. Should you have any questions regarding any of these steps or regarding    
  2544. the smart-launch of McAfee applications within NMS, please do not    
  2545. hesitate to contact McAfee Technical Support.   
  2546.  
  2547.